Freigeben über


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