IDirectMusicSegment::SetParam

The IDirectMusicSegment::SetParam method sets data on a track inside this segment.

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

Parameters

rguidType

Reference to (C++) or address of (C) the type of data to set. See Track Parameter Types.

dwGroupBits

Group that the desired track is in. Use 0xFFFFFFFF for all groups. For more information, see the Remarks for IDirectMusicPerformance::SetParam.

dwIndex

Index of the track in the group identified by dwGroupBits in which to set the data.

mtTime

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:

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

IDirectMusicPerformance::SetParam, IDirectMusicSegment::GetParam, IDirectMusicTrack::SetParam, Music Parameters