Platform SDK: DirectX

IDirectMusic::SetMasterClock

IDirectMusic::SetMasterClock メソッドは、IDirectMusic::EnumMasterClock を呼び出した際に取得された GUID によって識別されるクロックを、DirectMusic のマスタ クロックに設定する。すべての DirectMusic アプリケーションは、ただ 1 つのマスタ クロックを使う。

HRESULT SetMasterClock(
  REFGUID rguidClock
);

パラメータ

rguidClock
DirectMusic のマスタ クロックとして設定されるクロックを識別する GUID への参照 (C++) またはアドレス (C)。このパラメータは、IDirectMusic::EnumMasterClock メソッドが返した GUID でなければならない。

戻り値

成功すれば S_OK を返す。

失敗すれば DMUS_E_PORTS_OPEN を返す。

注意

実行中の他のアプリケーションも DirectMusic を使っている場合、そのアプリケーションがシャットダウンするまではマスタ クロックを変更できない。

ほどんどのアプリケーションは SetMasterClock を呼び出す必要がない。システムクロック以外のハードウェアタイマとの厳密な同期を必要としない限り、このメソッドを呼び出すべきではない。

動作環境

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

参照

IDirectMusic::GetMasterClockIDirectMusic::EnumMasterClock