IReferenceClock::AdviseTime メソッド (strmif.h)

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは AdviseTime 、ワンショット のアドバイス要求を作成します。

構文

HRESULT AdviseTime(
  [in]  REFERENCE_TIME baseTime,
  [in]  REFERENCE_TIME streamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD_PTR      *pdwAdviseCookie
);

パラメーター

[in] baseTime

基準基準時間 (100 ナノ秒単位)。 「解説」を参照してください。

[in] streamTime

Streamオフセット時間 (100 ナノ秒単位)。 「解説」を参照してください。

[in] hEvent

呼び出し元によって作成されたイベントを処理します。

[out] pdwAdviseCookie

アドバイス要求の識別子を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_OK
 正常終了しました。
E_INVALIDARG
 時刻の値が無効です。
E_OUTOFMEMORY
 失敗しました。
E_POINTER
 NULL ポインター引数。

注釈

このメソッドは、参照時間 rtBaseTime + rtStreamTime のワンショット アドバイス要求を作成します。 合計は 0 より大きく、MAX_TIME未満である必要があります。または、メソッドは E_INVALIDARGを返します。 要求された時刻に、 クロックは hEvent パラメーターで指定されたイベントを通知します。

時刻に達する前に通知を取り消すには、 Unadvise メソッドを呼び出し、この呼び出しから返された pdwAdviseToken 値を 渡します。 通知が発生すると、クロックによって自動的にクリアされるため、 Unadvise を呼び出す必要はありません。 ただし、エラーではありません。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

エラーコードと成功コード

IReferenceClock インターフェイス