Microsoft DirectX 8.0 (C++) |
Retrieves data from a track inside the control segment.
HRESULT GetParam( REFGUID rguidType, DWORD dwGroupBits, DWORD dwIndex, MUSIC_TIME mtTime, MUSIC_TIME* pmtNext, void* pParam );
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values:
DMUS_E_GET_UNSUPPORTED |
DMUS_E_NO_MASTER_CLOCK |
DMUS_E_NOT_FOUND |
DMUS_E_TRACK_NOT_FOUND |
E_POINTER |
Normally, the primary segment is the control segment. However, a secondary segment can be designated as a control segment when it is played. For more information, see Control Segments.
The data returned in *pParam can become invalid before the time returned in *pmtNext if another control segment is cued.
Each track belongs to one or more groups, and each group is represented by a bit in dwGroupBits. For more information, see IDirectMusicSegment8::InsertTrack and Identifying the Track.
Header: Declared in dmusici.h.
IDirectMusicPerformance8::SetParam, IDirectMusicSegment8::GetParam, IDirectMusicTrack8::GetParamEx, IDirectMusicPerformance8::SetGlobalParam, IDirectMusicPerformance8::GetTime, IDirectMusicPerformance8::GetParamEx, Performance Parameters