Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicTrack8::SetParamEx
The SetParamEx method sets data on a track, in either clock or music time.
Syntax
HRESULT SetParamEx(
REFGUID rguidType,
REFERENCE_TIME rtTime,
void* pParam,
void * pStateData,
DWORD dwFlags
);
Parameters
rguidType
Reference to (C++) or address of (C) the identifier of the type of data to set. See Standard Track Parameters.
rtTime
Time at which to set the data. Unless DMUS_TRACK_PARAMF_CLOCK is set in dwFlags, this is in music time.
pParam
Address of a structure that contains 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.
pStateData
Pointer to a buffer that contains state data for the track.
dwFlags
Can be 0 or the following flag.
Value | Description |
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 error values shown in the following table.
Return code |
DMUS_E_SET_UNSUPPORTED |
DMUS_E_TYPE_DISABLED |
E_OUTOFMEMORY |
E_POINTER |
Requirements
Header: Declared in dmplugin.h.
See Also
© 2004 Microsoft Corporation. All rights reserved.