ExCancelTimer-Funktion (wdm.h)
Die ExCancelTimer- Routine bricht einen Timer ab, der von einem 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 zugewiesen 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.
Bemerkungen
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 Timerobjekt festzulegen, bevor ein zuvor festgelegter Timer für dieses Objekt abläuft, wird dieser ExSetTimer- Aufruf implizit den vorherigen Timer abbricht und dann den neuen Timer startet.
Ein Rückgabewert von TRUE gibt an, dass der Timer festgelegt wurde, als ExCancelTimer- aufgerufen wurde. In diesem Fall bricht die Routine den Timer ab. Ein Rückgabewert von 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 der Timer bereits abgelaufen war. Wenn der Timer abläuft, bevor er abgebrochen wird, gibt ExCancelTimer FALSE zurück, und der Timer verbleibt im signalierten Zustand.
Wenn ein Timer abläuft, signalisiert das Betriebssystem das Timerobjekt. Als Option 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 vor Ablauf abgebrochen wird, wird das Timerobjekt nicht signalisiert, und die Rückrufroutine wird nicht aufgerufen.
Weitere Informationen finden Sie unter ExXxxTimer Routines und EX_TIMER Objects.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8.1. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | Ntoskrnl.lib |
| IRQL- | <= DISPATCH_LEVEL |