Platform SDK: DirectX

IDirectMusic::EnumMasterClock

IDirectMusic::EnumMasterClock メソッドは、DirectMusic がマスタ クロックとして利用できるクロックの記述の列挙と取得に使われる。このメソッドを呼び出すたびに、1 つのクロックに関する情報を取り出す。

HRESULT EnumMasterClock(
  DWORD dwIndex,
  LPDMUS_CLOCKINFO lpClockInfo
);

パラメータ

dwIndex
記述を取り出したいクロックのインデックス番号。最初に呼び出すときはこのパラメータを 0 に設定し、それ以降は呼び出しのたびに 1 ずつ大きくすべきである。S_FALSE が返されるまで呼び出しを続ける。
lpClockInfo
クロックの記述を受け取る DMUS_CLOCKINFO 構造体のアドレス。ポインタを渡す前に、アプリケーションはこの構造体の dwSize メンバを初期化しなければならない。

戻り値

成功すれば S_OK を返す。指定したインデックス番号を持つクロックが存在しない場合は S_FALSE を返す。

失敗すれば次のエラー値のいずれかを返す。

E_INVALIDARG
E_NOINTERFACE
E_POINTER

注意

アプリケーションはクロックのインデックス番号を信頼したり保存すべきではない。再起動またはハードウェアの追加や削除が行われると、クロックのインデックス番号が変化する可能性がある。

動作環境

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

参照

IDirectMusic::SetMasterClockIDirectMusic::GetMasterClock