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 表示未设置计时器，这可能意味着从未设置计时器、计时器已取消或计时器已过期。

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

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

要求

要求 值
最低受支持的客户端 从Windows 8.1开始可用。
目标平台 通用
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library Ntoskrnl.lib
IRQL <= DISPATCH_LEVEL

另请参阅

EX_TIMER

ExAllocateTimer

ExSetTimer