| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicSegment8::SetParam
The SetParam method sets data on a track inside this segment.
Syntax
HRESULT SetParam(
REFGUID rguidType,
DWORD dwGroupBits,
DWORD dwIndex,
MUSIC_TIME mtTime,
void* pParam
);
Parameters
rguidType
Reference to (C++) or address of (C) the type of data to set. See Standard Track Parameters.
dwGroupBits
Group that the desired track is in. Use 0xFFFFFFFF for all groups. For more information, see Identifying the Track.
dwIndex
Index of the track in the group identified by dwGroupBits in which to set the data, or DMUS_SEG_ALLTRACKS to set the parameter on all tracks in the group that contain the parameter.
mtTime
Time at which to set the data.
pParam
Address of a structure containing the data, or NULL if no data is required for this parameter. The structure must be of the appropriate kind and size for the data type identified by rguidType.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| DMUS_E_SET_UNSUPPORTED |
| DMUS_E_TRACK_NOT_FOUND |
| E_POINTER |
Requirements
Header: Declared in dmusici.h.
See Also
- IDirectMusicSegment8 Interface
- IDirectMusicPerformance8::SetParam
- IDirectMusicSegment8::GetParam
- IDirectMusicTrack8::SetParamEx
- Performance Parameters
© 2004 Microsoft Corporation. All rights reserved.