Microsoft DirectX 8.0 (C++) |
指定されたトラックを、セグメントのトラックのリストに挿入する。
HRESULT InsertTrack( IDirectMusicTrack* pTrack, DWORD dwGroupBits );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DMUS_E_NOT_INIT |
E_FAIL |
E_INVALIDARG |
E_OUTOFMEMORY |
E_POINTER |
トラックは互いが正しくリンクするようにグループで配置される。たとえば、セグメントには、スタイル トラックとミュート トラックがそれぞれ 2 つ含まれる場合がある。各スタイル トラックは、それらに関連付けられているミュート トラックと共に異なるグループに配置される。トラック グループの詳細については、「トラックの識別」を参照すること。
セグメントが現在演奏中の場合、新しいトラックは再生に含まれない。これは、セグメント状態の初期化の際に新しいトラックは含まれていなかったためである。
このメソッドによりトラックは初期化される。ただし、それ以降にトラック データが変更される場合、アプリケーションは IDirectMusicTrack8::Init を呼び出して、トラックを再び初期化する必要がある。
ヘッダー : dmusici.h で宣言。
IDirectMusicSegment8::RemoveTrack、IDirectMusicSegment8::GetTrackGroup