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) |