Microsoft DirectX 8.0 (C++)

IReferenceClock::AdvisePeriodic

持続時間が経過したことを示す、非同期の定期的な通知を要求する。

HRESULT AdvisePeriodic(
  REFERENCE_TIME rtStartTime,
  REFERENCE_TIME rtPeriodTime,
  HANDLE hSemaphore,
  DWORD * pdwAdviseCookie
);

パラメータ

rtStartTime
通知が開始されるタイム。
rtPeriodTime
通知が行われる間隔。
hSemaphore
アドバイスを行うための手段となるセマフォのハンドル。
pdwAdviseCookie
要求の識別子を受け取る変数のアドレス。これを使って、将来、要求をキャンセルする場合などに、AdvisePeriodic の呼び出しを識別する。

戻り値

戻り値は実装によって決まる。成功した場合は S_OK を返す。

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

E_FAIL
E_POINTER
E_INVALIDARG
E_NOTIMPL

注意

rtStartTime によって示されるタイムに達した場合、ハンドルが hSemaphore として設定されているセマフォが解放される。それ以降、セマフォは rtPeriodTime の期間を使って反復的に解放される。

動作環境

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

参照

IReferenceClock::Unadvise