Microsoft DirectX 9.0

IDirectMusicTrack8::Join

The Join method appends one track to another.

Syntax

HRESULT Join(
  IDirectMusicTrack* pNewTrack,
  MUSIC_TIME mtJoin,
  IUnknown* pContext,
  DWORD dwTrackGroup,
  IDirectMusicTrack** ppResultTrack)
);

Parameters

pNewTrack

Pointer to an IDirectMusicTrack8 interface that specifies the track to append to this one.

mtJoin

Time within this track where pNewTrack is to begin.

pContext

IUnknown interface pointer of the context segment. This object determines the time signature for tracks that use measures and beats, such as the signpost track.

dwTrackGroup

Group or groups to which the new track belongs. For more information on track groups, see IDirectMusicSegment8::InsertTrack and Identifying the Track.

ppResultTrack

Address of a variable that receives the IDirectMusicTrack interface of the concatenated track. Use QueryInterface to obtain IDirectMusicTrack8. If NULL, no new track is created and the current track becomes the concatenated track.

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_POINTER
E_INVALIDARG
E_OUTOFMEMORY

Remarks

This method is supported by the band, chordmap, tempo, style, chord, signpost, and command tracks.

Requirements

  Header: Declared in dmplugin.h.

See Also