Platform SDK: DirectX

IReferenceClock::AdviseTime

IReferenceClock::AdviseTime メソッドは、タイムが経過した非同期通知を要求する。

HRESULT AdviseTime(
  REFERENCE_TIME rtBaseTime,
  REFERENCE_TIME rtStreamTime,
  HEVENT hEvent,
  DWORD * pdwAdviseCookie
);

パラメータ

rtBaseTime
基本となる基準タイム。
rtStreamTime
ストリーム オフセット タイム。
hEvent
アドバイスを行うための手段となるイベントのハンドル。
pdwAdviseCookie
要求の識別子を受け取る変数のアドレス。これを使って、将来、要求をキャンセルする場合などに、AdviseTime の呼び出しを識別する。

戻り値

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

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

E_FAIL
E_POINTER
E_INVALIDARG
E_NOTIMPL

注意

rtBaseTime rtStreamTime を足したタイムに達すると、ハンドルが hEvent のイベントが設定される。タイムが既に経過している場合、イベントは即座に設定される。

動作環境

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

参照

IReferenceClock::Unadvise