Microsoft DirectX 8.0 (C++)

IDirectMusicSegmentState8::SetTrackConfig

Sets the configuration settings of a track.

HRESULT SetTrackConfig(
  REFGUID rguidTrackClassID,
  DWORD dwGroupBits, 
  DWORD dwIndex,
  DWORD dwFlagsOn,
  DWORD dwFlagsOff
);

Parameters

rguidTrackClassID
Reference to (C++) or address of (C) the identifier of the track class. For a list of values, see Standard Track Types.
dwGroupBits
Groups to which the track belongs.
dwIndex
Index of the track within the group, or DMUS_SEG_ALLTRACKS to set the configuration of all tracks in the group.
dwFlagsOn
Configuration flags to set. For a list of values, see IDirectMusicSegment8::SetTrackConfig.
dwFlagsOff
Configuration flags to clear.

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_TRACK_NOT_FOUND
E_INVALIDARG

Remarks

Any change in configuration takes effect after prepare time. If you want the change to take effect immediately, call IDirectMusicPerformance8::Invalidate.

Requirements

  Header: Declared in dmusici.h.

See Also

IDirectMusicSegment8::SetTrackConfig, Self-Controlling Segments, Track Configuration