Microsoft DirectX 8.0 (C++) |
指定されたタイプ、グループ、およびインデックスに一致するトラックをトラック リストから検索し、DirectMusicTrack オブジェクトへのポインタを取得する。
HRESULT GetTrack( REFGUID rguidType, DWORD dwGroupBits, DWORD dwIndex, IDirectMusicTrack** ppTrack );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DMUS_E_NOT_FOUND |
E_FAIL |
E_POINTER |
すべてのトラックを列挙するには、rguidType に GUID_NULL、dwGroupBits に 0xFFFFFFFF を指定する。最初は dwIndex を 0 に設定して GetTrack を呼び出し、メソッドが成功コードを返さなくなるまで dwIndex をインクリメントして呼び出しを続ける。
DirectMusic Producer で作成されるセグメントのトラックは、必ずしもアプリケーションと同じ順序である必要はない。特定のトラックの検索を dwIndex だけに頼らないこと。
トラック グループの詳細については、「トラックの識別」を参照すること。
ヘッダー : dmusici.h で宣言。