exDeleteTimer 函式 (wdm.h)

發行項
02/29/2024

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;否則，就會發生錯誤檢查。

[in] Wait

如果定時器已經啟動到期的程式，是否要等候定時器完成到期。如果為 TRUE，則例程會等候定時器到期。如果 為 FALSE，則例程不會等候。如需詳細資訊，請參閱＜備註＞。

[in] Parameters

EXT_DELETE_PARAMETERS 結構的指標。呼叫驅動程式先前稱為 ExInitializeDeleteTimerParameters 例程，以初始化這個結構。

傳回值

如果 Cancel 為 TRUE 且定時器已取消，則此例程會傳回 TRUE。否則，例程會傳回 FALSE。如需詳細資訊，請參閱＜備註＞。

備註

驅動程式呼叫此例程之後，Timer 所指向的定時器物件可能不再有效。不過，如果驅動程式實作此例程，則傳遞至 ExTimerCallback 回呼例程的 Timer 參數值一律是定時器物件的有效指標。

如果 Cancel 為 TRUE， 則 FALSE 的傳回值表示從未設定定時器，或定時器已設定，但在取消之前已過期。如果 Cancel 為 FALSE，則例程一律會傳回 FALSE。

如果 Wait 為 TRUE，此例程可能會封鎖。如果從驅動程式的 ExTimerCallback 例程呼叫 ExDeleteTimer，這會在DISPATCH_LEVEL呼叫，則此呼叫中的 Wait 參數必須是 FALSE。

如果 Wait 為 TRUE，則必須在 IRQL <= APC_LEVEL呼叫例程。如果 Wait 為 FALSE，則可以在 IRQL <= DISPATCH_LEVEL呼叫例程。

如需詳細資訊，請參閱刪除 System-Allocated 定時器物件。

規格需求

需求	值
最低支援的用戶端	從 Windows 8.1 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	Ntoskrnl.lib
IRQL	請參閱＜備註＞。