ExDeleteTimer-Funktion (wdm.h)

Die ExDeleteTimer Routine löscht ein Timerobjekt, das zuvor von der ExAllocateTimer Routine zugeordnet wurde.

Syntax

BOOLEAN ExDeleteTimer(
  [in] PEX_TIMER              Timer,
  [in] BOOLEAN                Cancel,
  [in] BOOLEAN                Wait,
  [in] PEXT_DELETE_PARAMETERS Parameters
);

Parameter

[in] Timer

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

[in] Cancel

Gibt an, ob der Timer abgebrochen werden soll, wenn er zurzeit festgelegt ist. Wenn TRUE, bricht die Routine den Timer ab, wenn der Timer festgelegt ist. Wenn FALSE, wird der Timer nicht abgebrochen, wenn er festgelegt ist. Wenn der Aufrufer Wait auf TRUEfestlegt, muss Cancel auch TRUEsein; andernfalls tritt eine Fehlerüberprüfung auf.

[in] Wait

Gibt an, ob auf den Ablauf des Timers gewartet werden soll, wenn der Timer den Ablaufvorgang bereits gestartet hat. Wenn TRUE, wartet die Routine, bis der Timer abläuft. Wenn FALSE-, wartet die Routine nicht. Weitere Informationen finden Sie in den Hinweisen.

[in] Parameters

Ein Zeiger auf eine EXT_DELETE_PARAMETERS Struktur. Der aufrufende Treiber hat zuvor die ExInitializeDeleteTimerParameters Routine aufgerufen, um diese Struktur zu initialisieren.

Rückgabewert

Diese Routine gibt TRUE zurück, wenn CancelTRUE- ist und der Timer abgebrochen wurde. Andernfalls gibt die Routine FALSE-zurück. Weitere Informationen finden Sie in den Hinweisen.

Bemerkungen

Nachdem Der Treiber diese Routine aufgerufen hat, ist das Timerobjekt, auf das Timer- verweist, möglicherweise nicht mehr gültig. Der Timer Parameterwert, der an eine ExTimerCallback Rückrufroutine übergeben wurde, ist jedoch immer ein gültiger Zeiger auf ein Timerobjekt, wenn der Treiber diese Routine implementiert.

Wenn CancelTRUEist, gibt ein Rückgabewert von FALSE- an, dass der Timer nie festgelegt wurde oder dass der Timer festgelegt wurde, aber abgelaufen war, bevor er abgebrochen werden konnte. Wenn CancelFALSE-ist, gibt die Routine immer FALSEzurück.

Diese Routine kann blockieren, wenn WaitTRUEist. Wenn ExDeleteTimer- aus der ExTimerCallback- Routine des Treibers aufgerufen wird, die bei DISPATCH_LEVEL aufgerufen wird, muss der parameter Wait in diesem Aufruf FALSEsein.

Wenn WaitTRUEist, muss die Routine bei IRQL <= APC_LEVEL aufgerufen werden. Wenn WaitFALSE-ist, kann die Routine bei IRQL <= DISPATCH_LEVEL aufgerufen werden.

Weitere Informationen finden Sie unter Löschen eines System-Allocated Timer-Objekts.

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-	Siehe Anmerkungen.

Siehe auch

EXT_DELETE_PARAMETERS

EX_TIMER

ExAllocateTimer-

ExInitializeDeleteTimerParameters

ExTimerCallback-

ExTimerDeleteCallback-