| Microsoft DirectX 9.0 SDK Update (October 2004) |
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