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 接口