Platform SDK: DirectX |
IDirectMusicSegment::InsertTrack メソッドは、指定されたトラックを、セグメントのリストトラックに挿入する。
HRESULT InsertTrack( IDirectMusicTrack* pTrack, DWORD dwGroupBits );
成功すれば 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::RemoveTrack、IDirectMusicSegment::GetTrackGroup