Platform SDK: DirectX

IDirectMusicSegment::InsertTrack

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

HRESULT InsertTrack(
  IDirectMusicTrack* pTrack,
  DWORD dwGroupBits
);

パラメータ

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

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

E_FAIL
E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

注意

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

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

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicSegment::RemoveTrackIDirectMusicSegment::GetTrackGroup