KeInitializeDeviceQueue function (wdm.h)

The KeInitializeDeviceQueue routine initializes a device queue object to a not-busy state.

Syntax

void KeInitializeDeviceQueue(
  [out] PKDEVICE_QUEUE DeviceQueue
);

Parameters

[out] DeviceQueue

Pointer to a device queue object for which the caller provides the storage.

Return value

None

Remarks

KeInitializeDeviceQueue initializes the specified device queue and sets its state to not-busy.

A driver should call KeInitializeDeviceQueue from its AddDevice routine after creating the device object for the associated device. Storage for the device queue object must be resident: in the device extension of a driver-created device object, in the controller extension of a driver-created controller object, or in nonpaged pool allocated by the caller.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI compliance rules HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm)

See also

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue