|Microsoft DirectX 9.0|
The 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 );
Reference to (C++) or address of (C) the identifier of the type of data to retrieve. See Standard Track Parameters.
Group of the track from which to retrieve the data (see Remarks). Set this value to 0xFFFFFFFF for all groups.
Index of the track in the group from which to retrieve the data, or DMUS_SEG_ANYTRACK to find the first track that contains the parameter.
Time from which to retrieve the data, in performance time.
Address of a variable that receives the time (relative to mtTime) until which the data is valid. If this returns a value of 0, either the data is always valid, or it is not known when it might become invalid. If this information is not needed, pmtNext can be set to NULL. See Remarks.
Address of an allocated structure in which the data is to be returned. The structure must be of the appropriate kind and size for the data type identified by rguidType.
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.
Normally, the primary segment is the control segment. However, a secondary segment can be designated as a control segment when it is played.
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.