DirectX SDK

IDirectMusicTrack::SetParam

The IDirectMusicTrack::SetParam method sets data on a track.

HRESULT SetParam(
  REFGUID rguidType,
  MUSIC_TIME mtTime,
  void* pParam
);

Parameters

rguidType
Reference to (C++) or address of (C) the identifier of the type of data to set. See Track Parameter Types.
mtTime
Time, in track time, at which to set the data.
pParam
Address of a structure containing the data, or NULL if no data is required. The structure must be of the appropriate kind and size for the data type identified by rguidType.

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:

DMUS_E_SET_UNSUPPORTED
DMUS_E_TYPE_DISABLED
E_OUTOFMEMORY
E_POINTER

Requirements

  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.

See Also

IDirectMusicTrack::GetParam, IDirectMusicTrack::IsParamSupported, IDirectMusicPerformance::SetParam, IDirectMusicSegment::SetParam, Setting and Retrieving Track Parameters