Platform SDK: DirectX

IDirectMusicSegment::GetTrack

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

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

パラメータ

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

戻り値

成功すれば S_OK を返す。

失敗すれば E_FAIL を返す。

注意

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

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

動作環境

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

参照

IDirectMusicSegment::InsertTrack