使用計時器

  • 發行項

本主題描述如何使用架構的內建計時器支援。 它同時適用于Kernel-Mode Driver Framework (KMDF) 驅動程式，以及從第 2 版開始User-Mode Driver Framework (UMDF) 驅動程式。

架構提供 計時器物件 ，可讓驅動程式建立計時器。 在驅動程式建立計時器物件並啟動計時器時鐘之後，架構會在經過指定的時間量之後呼叫驅動程式提供的回呼函式。 您可以選擇性地設定計時器，讓架構在經過指定的時間量時重複呼叫回呼函式。

若要建立架構計時器物件，您的驅動程式必須呼叫 WdfTimerCreate 方法。 這個方法會註冊 EvtTimerFunc 回呼函式和定期時間間隔。 如果您希望架構只呼叫回呼函式一次，驅動程式會針對定期時間間隔指定零。

一般而言，您將會知道驅動程式針對每個裝置所需的計時器數目。 因此，驅動程式可以藉由在其EvtDriverDeviceAdd回呼函式中呼叫WdfTimerCreate來建立計時器物件，而且可以將計時器物件控制碼儲存在裝置或佇列物件的內容空間中。

若要啟動計時器，您的驅動程式會呼叫 WdfTimerStart，並傳遞「到期時間」。 當指定的時間量經過時，架構會啟動計時器的時鐘，並呼叫 EvtTimerFunc 回呼函式。

如果驅動程式在稱為 WdfTimerCreate時提供定期時間間隔，定時 器稱為定期計時器。 定期計時器的時鐘會在初始「到期時間」經過之後繼續執行，而架構會在經過定期時間間隔時重複呼叫驅動程式的回呼函式。 定期計時器不會自動啟動。 就像非定期計時器一樣，驅動程式在建立計時器後仍必須呼叫 WdfTimerStart ，才能第一次啟動它。

驅動程式可能會從其EvtTimerFunc回呼函式呼叫WdfTimerStart，以便在到期後重新開機非定期計時器。

若要停止計時器，驅動程式可以呼叫 WdfTimerStop。 您的驅動程式可以重複啟動和停止計時器來重複使用計時器。

當您的驅動程式建立計時器物件時，它必須指定父物件。 架構會停止計時器，並在刪除父代時刪除計時器物件。 若要取得計時器的父物件，您的驅動程式可以呼叫 WdfTimerGetParentObject。

在 1.9 版之前的 KMDF 版本中，如果您希望所有驅動程式的回呼函式在 IRQL = PASSIVE_LEVEL執行，則無法輕易地使用計時器物件。 架構會將計時器物件的 EvtTimerFunc 回呼函式實作為延遲程序呼叫， (在 IRQL = DISPATCH_LEVEL呼叫的 DPC) 。 因此，如果您想要讓計時器到期程式碼在 PASSIVE_LEVEL EvtTimerFunc 回呼函式執行，必須將在 PASSIVE_LEVEL 上執行 的工作專案 排入佇列。

在 KMDF 1.9 版和更新版本中，您可以建立 被動層級計時器，這是在PASSIVE_LEVEL執行的計時器。 若要建立被動層級計時器，請在驅動程式呼叫WdfTimerCreate時指定WdfExecutionLevelPassive執行層級。 因此，架構會將 EvtTimerFunc 回呼函式實作為在 PASSIVE_LEVEL 上執行的工作專案。 請注意，被動層級計時器不能是定期計時器。

從 UMDF 2.0 版開始，架構會實作計時器物件的 EvtTimerFunc 回呼函式，作為使用者模式執行緒集區的背景工作執行緒。 因此，UMDF 驅動程式的計時器回呼函式一律會在PASSIVE_LEVEL執行。

沒有喚醒計時器

系統電源效率會由重複導致系統從低電源狀態繼續的計時器減少。 改善電池使用時間的其中一種方式是延遲非重大定期作業，而不是喚醒系統。 從Windows 8.1開始，您無法使用喚醒計時器在 KMDF 或 UMDF 驅動程式中執行這類非重大作業。 當系統處於低電源狀態時，沒有喚醒計時器不會喚醒系統。 相反地，架構會在下次系統完全開啟 S0 狀態時呼叫驅動程式的 EvtTimerFunc 回呼函式。

從 KMDF 1.13 版和 UMDF 2.0 版開始，沒有可用的喚醒計時器。

若要建立沒有喚醒計時器，請將WDF_TIMER_CONFIG的TolerableDelay成員設定為TolerableDelayUnlimited。

如需沒有喚醒計時器的詳細資訊，請參閱 無喚醒計時器。

高解析度計時器

標準架構計時器具有符合系統時鐘刻度間隔的正確性，預設為 15.6 毫秒。 從Windows 8.1開始，您可以建立高解析度計時器。 高解析度計時器精確度為 1 毫秒。 對於需要精確且可預測的到期時間的重要作業，您可以使用高解析度計時器。 由於需要經常維護，高解析度計時器可能會導致電池使用時間降低。

高解析度計時器僅適用于 KMDF 驅動程式，從 KMDF 1.13 版開始。

若要建立高解析度計時器，請將WDF_TIMER_CONFIG的UseHighResolutionTimer成員設定為WdfTrue，然後將Period值調整為所需的解析度。

下表根據驅動程式針對 Period提供的不同值，顯示計時器行為的範例。 這些範例假設系統時鐘刻度間隔為 15 毫秒。

Period，以毫秒為單位 標準計時器 高解析度計時器

10

計時器會在 0 毫秒到 25 毫秒之間到期。

計時器會在 10 毫秒之後儘快到期。

16

計時器會在 15 毫秒到 30 毫秒之間到期。

計時器會在 16 毫秒之後儘快到期。

如需高解析度計時器的詳細資訊，請參閱 高解析度計時器。

如需計時器精確度如何與系統時鐘細微性相關的詳細資訊，請參閱 計時器精確度。