Microsoft DirectX 9.0 SDK Update (October 2004)

IDirectMusicTrack8::Compose

The Compose method recomposes the track based on data from a segment. DirectMusic implements this method on the signpost track to compose a chord track.

Syntax

HRESULT Compose(
  IUnknown* pContext,
  DWORD dwTrackGroup,
  IDirectMusicTrack** ppResultTrack
 );

Parameters

pContext

IUnknown interface pointer of the object to use in the composition. This is usually the segment that owns this track.

dwTrackGroup

DWORD value that specifies group bits for the track. For more information on group bits, see Identifying the Track.

ppResultTrack

Address of a variable that receives the IDirectMusicTrack interface of the composed track. Use QueryInterface to obtain IDirectMusicTrack8.

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

Requirements

  Header: Declared in dmplugin.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.