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
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |