Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::InsertTrack

指定されたトラックを、セグメントのトラックのリストに挿入する。

HRESULT InsertTrack(
  IDirectMusicTrack* pTrack,
  DWORD dwGroupBits
);

パラメータ

pTrack
セグメントに追加されるトラック。
dwGroupBits
トラックの挿入先となる、1 つまたは複数のグループ。この値は 0 にできない。

戻り値

成功した場合は S_OK を返す。

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

DMUS_E_NOT_INIT
E_FAIL
E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

注意

トラックは互いが正しくリンクするようにグループで配置される。たとえば、セグメントには、スタイル トラックとミュート トラックがそれぞれ 2 つ含まれる場合がある。各スタイル トラックは、それらに関連付けられているミュート トラックと共に異なるグループに配置される。トラック グループの詳細については、「トラックの識別」を参照すること。

セグメントが現在演奏中の場合、新しいトラックは再生に含まれない。これは、セグメント状態の初期化の際に新しいトラックは含まれていなかったためである。

このメソッドによりトラックは初期化される。ただし、それ以降にトラック データが変更される場合、アプリケーションは IDirectMusicTrack8::Init を呼び出して、トラックを再び初期化する必要がある。

動作環境

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

参照

IDirectMusicSegment8::RemoveTrackIDirectMusicSegment8::GetTrackGroup