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。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
pdwAdviseCookie 参数为 NULL。 |
|
未知故障。 |