Microsoft DirectX 8.0 (C++)

IDirectMusic8::SetMasterClock

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

HRESULT SetMasterClock(
  REFGUID rguidClock
);

パラメータ

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

戻り値

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

失敗した場合は DMUS_E_PORTS_OPEN を返す。

注意

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

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

動作環境

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

参照

IDirectMusic8::SetExternalMasterClockIDirectMusic8::GetMasterClockIDirectMusic8::EnumMasterClock