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 IoTimer 例程,IoInitializeTimer 會傳回STATUS_SUCCESS。
言論
IoInitializeTimer 每個裝置物件只能呼叫一次。
驅動程式 IoTimer 例程會在驅動程式啟用定時器后每秒呼叫一次,方法是呼叫 ioStartTimer 。 驅動程式可以藉由呼叫 IoStopTimer 來停用定時器,並可以使用 IoStartTimer重新啟用它。
驅動程式的 IoTimer 例程是在 IRQL = DISPATCH_LEVEL呼叫,因此不能包含可分頁的程式代碼。
當定時器執行時,I/O 管理員會每秒呼叫驅動程式提供的 IoTimer 例程一次。 應以可變間隔或更精細粒度間隔呼叫逾時例程的驅動程式,可以設定 CustomTimerDpc 例程,並使用 KeXxxTimer 例程。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport)、IrqlIoPassive5(wdm)、PowerIrpDDis(wdm) |