KeInitializeDeviceQueue-Funktion (wdm.h)

Die KeInitializeDeviceQueue-Routine initialisiert ein Gerätewarteschlangenobjekt in einen Nicht-Gebucht-Zustand.

Syntax

void KeInitializeDeviceQueue(
  [out] PKDEVICE_QUEUE DeviceQueue
);

Parameter

[out] DeviceQueue

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

Rückgabewert

Keine

Bemerkungen

KeInitializeDeviceQueue initialisiert die angegebene Gerätewarteschlange und legt ihren Status auf not-busy fest.

Ein Treiber sollte KeInitializeDeviceQueue aus seiner AddDevice-Routine aufrufen, nachdem das Geräteobjekt für das zugeordnete Gerät erstellt wurde. Der Speicher für das Gerätewarteschlangenobjekt muss sich in der Geräteerweiterung eines vom Treiber erstellten Geräteobjekts, in der Controllererweiterung eines vom Treiber erstellten Controllerobjekts oder in einem nicht ausgelagerten Pool befinden, der vom Aufrufer zugewiesen wird.

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	HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm)

Weitere Informationen

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue