IDirectMusicSegmentState8::SetTrackConfig

Microsoft DirectX 9.0 SDK Update (October 2004)

The SetTrackConfig method sets the configuration of a track in the parent segment.

Syntax

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 error values shown in the following table.

Return code

DMUS_E_TRACK_NOT_FOUND

Remarks

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

Requirements

Header: Dmusici.h
Library: Dmime.dll, Dmimed.dll

See Also