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 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 Ntoskrnl.lib
IRQL <= DISPATCH_LEVEL

另請參閱

EX_TIMER

ExAllocateTimer

ExSetTimer