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 |