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 Objects。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8.1 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 連結庫 | Ntoskrnl.lib |
| IRQL | <= DISPATCH_LEVEL |