IoInitializeTimer 函式 (wdm.h)
IoInitializeTimer 例程會設定與指定裝置對象相關聯的驅動程式提供的 IoTimer 例程。
語法
NTSTATUS IoInitializeTimer(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIO_TIMER_ROUTINE TimerRoutine,
[in, optional] __drv_aliasesMem PVOID Context
);
參數
[in] DeviceObject
代表 I/O 作業可能會逾時之裝置的裝置物件的指標。
[in] TimerRoutine
驅動程式提供的 IoTimer 例程指標。
[in, optional] Context
將呼叫其 IoTimer 例程之驅動程式決定內容的指標。
傳回值
如果已設定IoTimer例程，IoInitializeTimer會傳回STATUS_SUCCESS。
備註
每個裝置物件只能呼叫IoInitializeTimer一次。
驅動程式的 IoTimer 例程會在驅動程式呼叫 IoStartTimer來啟用定時器之後，每秒呼叫一次。 驅動程式可以藉由呼叫 IoStopTimer 來停用定時器，並使用 IoStartTimer重新啟用定時器。
驅動程式的 IoTimer 例程是在 IRQL = DISPATCH_LEVEL呼叫，因此不得包含可分頁的程式碼。
當定時器執行時，I/O 管理員會每秒呼叫驅動程式提供的 IoTimer 例程一次。 應該以可變間隔或更細微的間隔呼叫逾時例程的驅動程式可以設定 CustomTimerDpc 例程，並使用 KeXxx定時器 例程。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 IrqlIoPassive5 (wdm ) 、 PowerIrpDDis (wdm) |