KeInitializeTimerEx 函式 (wdm.h)

KeInitializeTimerEx 例程會初始化擴充的核心定時器物件。

語法

void KeInitializeTimerEx(
  [out] PKTIMER    Timer,
  [in]  TIMER_TYPE Type
);

[out] Timer

定時器物件的指標，呼叫端會為其提供記憶體。

[in] Type

指定 Timer 對象的類型，可以是 NotificationTimer 或 SynchronizationTimer。

無

定時器物件會初始化為未發出訊號的狀態。

定時器對象的記憶體必須駐留：在驅動程式建立裝置對象的裝置延伸模組、驅動程式建立控制器物件的控制器延伸模組，或呼叫端所配置的非分頁集區中。

當通知定時器過期時，所有等候的線程都會釋放，而且定時器會維持在訊號狀態，直到明確重設為止。當同步處理定時器過期時，它會設定為訊號狀態，直到釋放單一等候線程，然後定時器會重設為未發出訊號的狀態。

KeInitializeTimerEx 的呼叫端應該在 IRQL = DISPATCH_LEVEL 或更低位置執行。最好是在 IRQL = PASSIVE_LEVEL初始化定時器。

如需定時器對象的詳細資訊，請參閱定時器物件和 DPC。

使用 KeSetTimer 或 KeSetTimerEx 來定義定時器到期的時間。

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (请参阅一节)
DDI 合規性規則	HwStorPortProhibitedDDIs (storport) 、 IrqlKeDispatchLte (wdm)