CBaseReferenceClock.AdvisePeriodic 方法
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 AdvisePeriodic
创建定期建议请求。 此方法实现 IReferenceClock::AdvisePeriodic 方法。
语法
HRESULT AdvisePeriodic(
REFERENCE_TIME StartTime,
REFERENCE_TIME PeriodTime,
HSEMAPHORE hSemaphore,
DWORD_PTR *pdwAdviseToken
);
参数
-
StartTime
-
第一个通知的时间,以 100 纳秒为单位。 必须大于零且小于 MAX_TIME。
-
PeriodTime
-
通知间隔时间(以 100 纳秒为单位)。 必须大于零。
-
hSemaphore
-
由调用方创建的信号灯的句柄。
-
pdwAdviseToken
-
指向接收建议请求标识符的变量的指针。
返回值
返回下表中显示的 HRESULT 值之一。
返回代码 | 说明 |
---|---|
|
成功 |
|
无效的时间值 |
|
失败 |
|
NULL 指针参数 |
备注
在每次通知时,时钟都会释放 hSemaphore 参数中指定的信号灯 。 如果不需要其他通知,请调用 CBaseReferenceClock::Unadvise 方法并传递从此调用返回的 pdwAdviseToken 值。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|