Microsoft DirectX 8.0 (C++)

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 を返す。

失敗した場合は、次のいずれかのエラー値を返す。

E_POINTER
E_INVALIDARG
E_OUTOFMEMORY

注意

このメソッドは、バンド、コード マップ、テンポ、スタイル、コード、サインポスト、およびコマンドの各トラックでサポートされる。

動作環境

  ヘッダー : dmplugin.h で宣言。