IDirectMusicTrack8::Join
トラックを別のトラックの末尾に付加する。
HRESULT Join(
IDirectMusicTrack* pNewTrack,
MUSIC_TIME mtJoin,
IUnknown* pContext,
DWORD dwTrackGroup,
IDirectMusicTrack** ppResultTrack)
);
パラメータ
- pNewTrack
- このトラックの後に付加するトラックを指定する IDirectMusicTrack8 インターフェイスへのポインタ。
- mtJoin
- pNewTrack を開始する、このトラックでのタイム。
- pContext
- コンテキスト セグメントの IUnknown インターフェイス ポインタ。このオブジェクトから、サインポスト トラックなど、小節や拍を使用するトラックの拍子記号が決定される。
- dwTrackGroup
- 新しいトラックが属する、1 つまたは複数のグループ。詳細については、「IDirectMusicSegment8::InsertTrack」および「トラックの識別」を参照すること。
- ppResultTrack
- 連結済みトラックの IDirectMusicTrack インターフェイスを受け取る変数のアドレス。QueryInterface を使用して、IDirectMusicTrack8 を取得する。NULL の場合、新しいトラックは作成されず、現在のトラックが連結済みトラックとなる。
戻り値
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
注意
このメソッドは、バンド、コード マップ、テンポ、スタイル、コード、サインポスト、およびコマンドの各トラックでサポートされる。
ヘッダー : dmplugin.h で宣言。