ExCancelTimer-Funktion (wdm.h)

Die ExCancelTimer-Routine bricht einen Timer ab, der durch einen vorherigen Aufruf der ExSetTimer-Routine festgelegt wurde.

Syntax

BOOLEAN ExCancelTimer(
  [in, out]      PEX_TIMER              Timer,
  [in, optional] PEXT_CANCEL_PARAMETERS Parameters
);

Parameter

[in, out] Timer

Ein Zeiger auf eine EX_TIMER-Struktur . Diese Struktur ist ein Timerobjekt, das zuvor von der ExAllocateTimer-Routine zugeordnet wurde.

[in, optional] Parameters

Treiber müssen diesen Parameter auf NULL festlegen.

Rückgabewert

Diese Routine gibt TRUE zurück, wenn der Timer abgebrochen wurde. Andernfalls gibt die Routine FALSE zurück.

Hinweise

Nachdem Ihr Treiber die ExSetTimer-Routine aufgerufen hat, um den Timer festzulegen, wird der Timer möglicherweise abgebrochen, bevor er abläuft. Der Treiber kann die ExCancelTimer-Routine aufrufen, um einen ausstehenden Timer explizit abzubrechen. Wenn der Treiber die ExSetTimer-Routine aufruft, um einen neuen Timer für ein Zeitgeberobjekt festzulegen, bevor ein zuvor festgelegter Timer für dieses Objekt abläuft, bricht dieser ExSetTimer-Aufruf implizit den vorherigen Timer ab und startet dann den neuen Timer.

Der Rückgabewert TRUE gibt an, dass der Timer festgelegt wurde, als ExCancelTimer aufgerufen wurde. In diesem Fall bricht die Routine den Timer ab. Der Rückgabewert FALSE gibt an, dass der Timer nicht festgelegt wurde. Dies kann bedeuten, dass der Timer nie festgelegt wurde, dass der Timer bereits abgebrochen wurde oder dass der Timer bereits abgelaufen ist.

Wenn ein Timer abläuft, signalisiert das Betriebssystem das Timerobjekt. Optional kann ein Treiber eine ExTimerCallback-Rückrufroutine bereitstellen, die aufgerufen wird, wenn der Timer abläuft. Wenn der Treiber diese Rückrufroutine bereitstellt, wird diese Routine garantiert aufgerufen, wenn das Timerobjekt signalisiert wird. Wenn der Timer abgebrochen wird, bevor er abläuft, wird das Timerobjekt nicht signalisiert, und die Rückrufroutine wird nicht aufgerufen.

Weitere Informationen finden Sie unter ExXxxTimer-Routinen und EX_TIMER-Objekte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.1.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek Ntoskrnl.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

EX_TIMER

ExAllocateTimer

ExSetTimer