Microsoft DirectX 8.0 (C++)

IDirectMusicSong8::Compose

Not implemented in DirectX 8.0.

Creates playable segments from the source material in the song.

HRESULT Compose();

Parameters

None.

Return Values

If the method succeeds, one of the following success codes is returned:

S_OK The song was composed.
S_FALSE There were no tracks to be composed.
DMUS_S_GARBAGE_COLLECTED See Garbage Collection.

If it fails, the method can return one of the following error values.

DMUS_E_TRACK_NOT_FOUND
E_INVALIDARG
E_POINTER
E_OUTOFMEMORY

Remarks

The method finds all composing tracks in all segments in the song, joins tracks with the same class identifier and group bits into master composing tracks, composes new tracks from the master composing tracks in priority order, breaks these new tracks up so that they correspond to the original tracks, and inserts the smaller composed tracks into segments of the song in the appropriate places.

Requirements

  Header: Declared in dmusici.h.

See Also

IDirectMusicSegment8::Compose, IDirectMusicTrack8::Compose