共用方式為


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)

另請參閱

IoStartTimer

IoStopTimer

IoTimer

KeInitializeTimer

KeSetTimer