Función KeRemoveByKeyDeviceQueue (wdm.h)

La rutina KeRemoveByKeyDeviceQueue quita una entrada, seleccionada según un valor de clave de ordenación, de la cola de dispositivos especificada.

Sintaxis

PKDEVICE_QUEUE_ENTRY KeRemoveByKeyDeviceQueue(
  [in, out] PKDEVICE_QUEUE DeviceQueue,
  [in]      ULONG          SortKey
);

Parámetros

[in, out] DeviceQueue

Puntero a un objeto de cola de dispositivos inicializado para el que el autor de la llamada proporciona el almacenamiento.

[in] SortKey

Especifica la clave que se va a usar al buscar en el DeviceQueue.

Valor devuelto

KeRemoveByKeyDeviceQueue devuelve la entrada de cola del dispositivo que se quitó; devuelve NULL si la cola estaba vacía.

Observaciones

Esta rutina busca la primera entrada de la cola de dispositivos que tiene un valor mayor o igual que el SortKey. Una vez encontrada esta entrada, esta rutina quita la entrada de la cola de dispositivos y la devuelve. Si no se encuentra dicha entrada, se devuelve la primera entrada de la cola. Si la cola de dispositivos está vacía, el dispositivo se establece en un estado no ocupado y se devuelve un puntero NULL.

Es un error llamar a KeRemoveByKeyDeviceQueue cuando el objeto de cola de dispositivos está establecido en un estado no ocupado.

Requisitos

Consulte también

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

keInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue