ExCancelTimer 函数 (wdm.h)

ExCancelTimer 例程会取消先前对 ExSetTimer 例程的调用设置的计时器。

语法

BOOLEAN ExCancelTimer(
  [in, out]      PEX_TIMER              Timer,
  [in, optional] PEXT_CANCEL_PARAMETERS Parameters
);

参数

[in, out] Timer

指向 EX_TIMER 结构的指针。 此结构是以前由 ExAllocateTimer 例程分配的计时器对象。

[in, optional] Parameters

驱动程序必须将此参数设置为 NULL

返回值

如果计时器已取消,此例程将返回 TRUE。 否则,例程返回 FALSE

言论

驱动程序调用 ExSetTimer 例程以设置计时器后,计时器可能会在计时器过期之前取消。 驱动程序可以调用 ExCancelTimer 例程来显式取消挂起的计时器。 此外,如果驱动程序调用 ExSetTimer 例程来设置计时器对象上的新计时器,则在以前设置此对象的计时器过期之前,此 ExSetTimer 调用隐式取消上一个计时器,然后启动新的计时器。

返回值为 TRUE 指示在调用 exCancelTimer 时设置计时器。 在这种情况下,例程将取消计时器。 FALSE 的返回值 指示未设置计时器,这可能意味着从未设置计时器、已取消计时器或计时器已过期。 如果计时器在取消之前过期,ExCancelTimer 将返回 FALSE,并且计时器保持信号状态。

计时器过期时,作系统会向计时器对象发出信号。 作为选项,驱动程序可以提供 ExTimerCallback 计时器过期时调用的回调例程。 如果驱动程序提供此回调例程,则保证在发出计时器对象信号时调用此例程。 如果在计时器过期之前已取消,则不会向计时器对象发出信号,并且不会调用回调例程。

有关详细信息,请参阅 ExXxxTimer 例程和EX_TIMER对象

要求

要求 价值
最低支持的客户端 从 Windows 8.1 开始可用。
目标平台 普遍
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
Ntoskrnl.lib
IRQL <= DISPATCH_LEVEL

另请参阅

EX_TIMER

ExAllocateTimer

ExSetTimer