通过

IReferenceClockTimerControl：：SetDefaultTimerResolution 方法 (strmif.h)

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 SetDefaultTimerResolution 设置最小计时器分辨率。

语法

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

参数

[in] timerResolution

最小计时器分辨率，以 100 纳秒为单位。 如果值为零，则引用时钟将取消其上一个请求。

返回值

返回 HRESULT 值。 可能的值包括以下值。

返回代码 说明
S_OK
 成功。

注解

引用时钟尝试将计时器的周期设置为 timerResolution。 计时器的实际时间段可能会有所不同，具体取决于硬件。 若要查找最小和最大计时器分辨率，请调用 timeGetDevCaps 函数。 参考时钟通过调用 timeBeginPeriod 设置计时器分辨率。 如果 timerResolution 为 0，则该方法通过调用 timeEndPeriod 取消上一个计时器请求。 (当引用时钟被销毁时，它会自动取消任何以前的 request.)

如果未调用此方法，则参考时钟会将计时器分辨率设置为 1 毫秒。 若要获得最佳电源管理性能，建议使用值 0 调用此方法。 这会替代时钟的默认设置 1 毫秒。 如果图中的任何筛选器需要更高的计时器分辨率，则可以单独调用 timeBeginPeriod 。 通常，只有呈现器才需要特定的计时器分辨率。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IReferenceClockTimerControl 接口