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 |