Microsoft DirectX 8.0 (C++)

IDirectMusicTrack8::Join

Appends one track to another.

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 following error values.

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.