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 dispositivo 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 DeviceQueue.
Valor devuelto
KeRemoveByKeyDeviceQueue devuelve la entrada de cola del dispositivo que se quitó; devuelve NULL si la cola estaba vacía.
Comentarios
Esta rutina busca la primera entrada de la cola de dispositivos que tiene un valor mayor o igual que 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 .
Se produce un error al llamar a KeRemoveByKeyDeviceQueue cuando el objeto de cola del dispositivo está establecido en un estado no ocupado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |