KeRemoveByKeyDeviceQueue

PKDEVICE_QUEUE_ENTRY
KeRemoveByKeyDeviceQueue(
IN PKDEVICE_QUEUE DeviceQueue,
IN ULONG SortKey
);

KeRemoveByKeyDeviceQueue removes an entry, selected according to a sort-key value, from a given device queue.

Parameters

DeviceQueue: Points to an initialized device queue object for which the caller provides the storage.
SortKey: Specifies the position in the DeviceQueue from which the entry is to be removed.

Return Value

If the given device queue is empty but the device queue object�s state is Busy, KeRemoveByKeyDeviceQueue returns NULL.

Comments

It is an error to call KeRemoveByKeyDeviceQueue when the state of the device queue object is Not-Busy. If the state is Busy and an IRP is queued, this routine dequeues the entry and returns a pointer to the IRP. A call to KeRemoveByKeyDeviceQueue when the state of the device queue object is Busy but no IRPs are queued causes the state transition to Not-Busy.

Callers of KeRemoveByKeyDeviceQueue must be running at IRQL DISPATCH_LEVEL.