KeRemoveEntryDeviceQueue-Funktion (wdm.h)

Artikel
02/27/2024

Die KeRemoveEntryDeviceQueue-Routine gibt zurück, ob sich der angegebene Eintrag in der Gerätewarteschlange befindet, und entfernt ihn aus der Gerätewarteschlange, falls er in der Warteschlange war.

Syntax

BOOLEAN KeRemoveEntryDeviceQueue(
  [in, out] PKDEVICE_QUEUE       DeviceQueue,
  [in, out] PKDEVICE_QUEUE_ENTRY DeviceQueueEntry
);

Parameter

[in, out] DeviceQueue

Zeiger auf ein initialisiertes Gerätewarteschlangenobjekt, für das der Aufrufer den Speicher bereitstellt.

[in, out] DeviceQueueEntry

Zeiger auf den Eintrag, der aus der angegebenen DeviceQueue entfernt werden soll.

Rückgabewert

Wenn deviceQueueEntry in die Warteschlange eingereiht wird, wird sie entfernt, und KeRemoveEntryDeviceQueue gibt TRUE zurück.

Hinweise

IrQL ist auf DISPATCH_LEVEL festgelegt, und die DeviceQueue-Spinsperre wird abgerufen.

Wenn sich die angegebene DeviceQueueEntry nicht in der Warteschlange befindet, wird der IRP entweder bereits verarbeitet oder der IRP wurde abgebrochen. In diesem Fall gibt KeRemoveEntryDeviceQueue einfach FALSE zurück.

Die angegebene DeviceQueue-Spinsperre wird freigegeben, und IRQL wird auf den vorherigen Wert wiederhergestellt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)