共用方式為

IReferenceClockTimerControl：：SetDefaultTimerResolution 方法 (strmif.h)

  • 發行項

[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。

方法 SetDefaultTimerResolution 會設定最小定時器解析度。

語法

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

參數

[in] timerResolution

最小定時器解析度，以 100 奈秒為單位。 如果值為零，則參考時鐘會取消其先前的要求。

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 描述
S_OK
 成功。

備註

參考時鐘會嘗試將定時器的期間設定為 timerResolution。 根據硬體而定，定時器的實際期間可能會有所不同。 若要尋找最小和最大定時器解析度，請呼叫 timeGetDevCaps 函式。 參考時鐘會藉由呼叫 timeBeginPeriod 來設定定時器解析度。 如果 timerResolution 為 0，方法會呼叫 timeEndPeriod 來取消先前的定時器要求。 (當參考時鐘終結時，它會自動取消任何先前的要求。)

如果未呼叫這個方法，則參考時鐘會將定時器解析度設定為 1 毫秒。 若要取得最佳的電源管理效能，建議您使用零值呼叫此方法。 這會覆寫時鐘的預設設定 1 毫秒。 如果圖表中的任何篩選需要較高的定時器解析度，他們可以個別呼叫 timeBeginPeriod 。 通常只有轉譯器需要特定的定時器解析度。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IReferenceClockTimerControl 介面