Platform SDK: DirectX |
The IDirectMusicPerformance::GetParam method 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 on control segments, see Segments and DMUS_SEGF_FLAGS.
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 IDirectMusicSegment::InsertTrack and Identifying the Track.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dmusici.h.
IDirectMusicPerformance::SetParam, IDirectMusicSegment::GetParam, IDirectMusicTrack::GetParam, IDirectMusicPerformance::SetGlobalParam, IDirectMusicPerformance::GetTime, Music Parameters