IDirectMusicTrack8::GetParamEx
Retrieves data from a track, in either music or reference time.
HRESULT GetParamEx(
REFGUID rguidType,
REFERENCE_TIME rtTime,
REFERENCE_TIME* prtNext,
void * pParam
void * pStateData,
DWORD dwFlags
);
Parameters
- rguidType
- Reference to (C++) or address of (C) the identifier of the type of data to obtain. See Standard Track Parameters.
- rtTime
- Time from which to obtain the data. Unless DMUS_TRACK_PARAMF_CLOCK is set in dwFlags, this value is in music time.
- prtNext
- Address of a variable that receives the time until which the data is valid. If this returns a value of zero, either the data is always valid, or it is unknown when it might become invalid. If this information is not needed, prtNext can be set to NULL.
- pParam
- 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.
- pStateData
- Address of a buffer containing state data for the track instance. This value is obtained from IDirectMusicTrack8::InitPlay.
- dwFlags
- Can be zero or the following flag.
- DMUS_TRACK_PARAMF_CLOCK
- The value in rtTime is in clock time.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values.
Header: Declared in dmplugin.h.
See Also
IDirectMusicTrack8::GetParam, IDirectMusicTrack8::SetParamEx