Platform SDK: DirectX

IReferenceClock::AdvisePeriodic

IReferenceClock::AdvisePeriodic メソッドは、持続時間が経過した、非同期の期間通知を要求する。

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

パラメータ

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

戻り値

戻り値は実装によって決まる。成功すれば S_OK を返す。

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

E_FAIL
E_POINTER
E_INVALIDARG
E_NOTIMPL

注意

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

動作環境

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

参照

IReferenceClock::Unadvise