exDeleteTimer 函数 (wdm.h)

项目
08/08/2023

ExDeleteTimer 例程删除以前由 ExAllocateTimer 例程分配的计时器对象。

语法

BOOLEAN ExDeleteTimer(
  [in] PEX_TIMER              Timer,
  [in] BOOLEAN                Cancel,
  [in] BOOLEAN                Wait,
  [in] PEXT_DELETE_PARAMETERS Parameters
);

参数

[in] Timer

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

[in] Cancel

如果当前已设置计时器，是否取消计时器。如果 为 TRUE，则如果设置了计时器，则例程将取消计时器。如果 为 FALSE，则例程不会取消计时器（如果已设置）。如果调用方将 Wait 设置为 TRUE，则 Cancel 也必须为 TRUE;否则，将发生 bug 检查。

[in] Wait

如果计时器已启动过期过程，是否要等待计时器完成过期。如果 为 TRUE，则例程将等待计时器过期。如果 为 FALSE，则例程不会等待。有关详细信息，请参阅“备注”。

[in] Parameters

指向 EXT_DELETE_PARAMETERS 结构的指针。调用驱动程序之前调用 ExInitializeDeleteTimerParameters 例程来初始化此结构。

返回值

如果 Cancel 为 TRUE 且计时器已取消，则此例程返回 TRUE。否则，例程返回 FALSE。有关详细信息，请参阅“备注”。

注解

驱动程序调用此例程后，计时器指向的 计时器 对象可能不再有效。但是，传递给 ExTimerCallback 回调例程的 Timer 参数值（如果驱动程序实现此例程）始终是指向计时器对象的有效指针。

如果 Cancel 为 TRUE，则返回值 FALSE 表示从未设置计时器，或者计时器已设置但已过期，然后才能取消计时器。如果 Cancel 为 FALSE，则例程始终返回 FALSE。

如果 Wait 为 TRUE，则此例程可能会受阻。如果从驱动程序的 ExTimerCallback 例程（DISPATCH_LEVEL调用）调用 ExDeleteTimer，则此调用中的 Wait 参数必须为 FALSE。

如果 Wait 为 TRUE，则必须在 IRQL <= APC_LEVEL调用例程。如果 Wait 为 FALSE，则可以在 IRQL <= DISPATCH_LEVEL调用例程。

有关详细信息，请参阅删除 System-Allocated 计时器对象。

要求

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