KeInitializeTimer 函式 (wdm.h)
KeInitializeTimer 例程會初始化定時器物件。
語法
void KeInitializeTimer(
[out] PKTIMER Timer
);
參數
[out] Timer
定時器物件的指標,呼叫端會為其提供記憶體。
傳回值
無
備註
定時器物件會初始化為未發出訊號的狀態。
定時器對象的記憶體必須駐留:位於驅動程式所建立裝置對象的裝置延伸模組、驅動程式建立控制器物件的控制器擴充功能中,或位於呼叫端所配置的非分頁集區中。
KeInitializeTimer 只能初始化通知定時器。 使用 KeInitializeTimerEx 初始化通知定時器或同步處理定時器。
使用 KeSetTimer 或 KeSetTimerEx 來定義定時器到期的時間。
如需定時器對象的詳細資訊,請參閱 定時器物件和 DPC。
KeInitializeTimer 的呼叫端應該在 IRQL = DISPATCH_LEVEL 或更低版本執行。 最好是在 IRQL = PASSIVE_LEVEL初始化定時器。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL (请参阅一节) |
DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 IrqlKeDispatchLte (wdm) |