Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::GetTrack

指定されたタイプ、グループ、およびインデックスに一致するトラックをトラック リストから検索し、DirectMusicTrack オブジェクトへのポインタを取得する。

HRESULT GetTrack(
  REFGUID rguidType,
  DWORD dwGroupBits,
  DWORD dwIndex,
  IDirectMusicTrack** ppTrack
);

パラメータ

rguidType
検索するトラックのクラス識別子への参照 (C++) またはアドレス (C)。値として GUID_NULL を指定すると、任意のトラックを取得する。トラック識別子については、「標準トラックの種類」を参照すること。
dwGroupBits
検索されるトラックを含むトラック グループ。値 0 は無効である。dwGroupBits 内の各ビットは、1 つのトラック グループに対応する。グループにかかわりなくすべてのトラックを検索するには、このパラメータを 0xFFFFFFFF に設定する。
dwIndex
rguidType タイプ、なおかつ dwGroupBits に一致するために返されたグループから 1 つのトラックを識別するために使われる、0 から始まるインデックス。dwGroupBits で複数のグループが選択されている場合、選択されたグループの集合の中で見つかった pCommandGuid タイプから、このインデックスは n 番目のトラックを指定する。「注意」を参照すること。
ppTrack
トラックへのポインタを受け取る変数のアドレス。トラックが見つからなかった場合、この変数は NULL に設定される。

戻り値

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

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

DMUS_E_NOT_FOUND
E_FAIL
E_POINTER

注意

すべてのトラックを列挙するには、rguidType に GUID_NULL、dwGroupBits に 0xFFFFFFFF を指定する。最初は dwIndex を 0 に設定して GetTrack を呼び出し、メソッドが成功コードを返さなくなるまで dwIndex をインクリメントして呼び出しを続ける。

DirectMusic Producer で作成されるセグメントのトラックは、必ずしもアプリケーションと同じ順序である必要はない。特定のトラックの検索を dwIndex だけに頼らないこと。

トラック グループの詳細については、「トラックの識別」を参照すること。

動作環境

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

参照

IDirectMusicSegment8::InsertTrack