Share via

IReferenceClock::AdviseTime メソッド

  • [アーティクル]

[このページに関連付けられている機能である Windows Media Format 11 SDK は、従来の機能です。 ソース リーダーとシンク ライターに置き換わりました。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 Microsoft では、可能であれば、新しいコードで Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

AdviseTime メソッドは、時間が経過したことを非同期通知を要求します。

構文

HRESULT AdviseTime(
  [in]  REFERENCE_TIME rtBaseTime,
  [in]  REFERENCE_TIME rtStreamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD          *pdwAdviseCookie
);

パラメーター

rtBaseTime [in]

基本参照時間 (100 ナノ秒単位)。

rtStreamTime [in]

ストリーム オフセット時間 (100 ナノ秒単位)。

hEvent [in]

呼び出し元によって作成されたイベントを処理します。 このイベントは、指定された時間が経過すると通知されます。

pdwAdviseCookie [out]

要求の識別子を受け取る変数へのポインター。 これは、要求を取り消すなど、将来 の AdviseTime へのこの呼び出しを識別するために使用されます。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_POINTER
 pdwAdviseCookie パラメーターは NULL です。
E_FAIL
 不特定のエラー。

関連項目

IReferenceClock インターフェイス