Microsoft DirectX 8.0 (C++)

IReferenceClock::AdviseTime

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

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

パラメータ

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

戻り値

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

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

E_FAIL
E_POINTER
E_INVALIDARG
E_NOTIMPL

注意

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

動作環境

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

参照

IReferenceClock::Unadvise