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)

另請參閱

IoStartTimer

IoStopTimer

IoTimer

KeInitializeTimer

KeSetTimer