Compartir a través de


Función KeRemoveDeviceQueue (wdm.h)

La rutina KeRemoveDeviceQueue quita una entrada del encabezado de una cola de dispositivos especificada.

Sintaxis

PKDEVICE_QUEUE_ENTRY KeRemoveDeviceQueue(
  [in, out] PKDEVICE_QUEUE DeviceQueue
);

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.

Valor devuelto

Si la cola de dispositivos está vacía, pero está establecida en un estado ocupado, KeRemoveDeviceQueue devuelve NULL.

Observaciones

Se adquiere el bloqueo de número de cola de dispositivos especificado y se comprueba el estado de la cola de dispositivos. Si la cola de dispositivos se establece en un estado ocupado y se pone en cola un IRP, esta rutina pone en cola la entrada y devuelve un puntero al IRP. Una llamada a KeRemoveDeviceQueue cuando el objeto de cola de dispositivos está establecido en un estado ocupado, pero ningún IRP se pone en cola provoca un cambio de estado a no ocupado. Se libera el bloqueo de número de cola de dispositivo especificado.

Se trata de un error llamar a KeRemoveDeviceQueue 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)

Consulte también

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

keInsertDeviceQueue

KeRemoveByKeyDeviceQueue

KeRemoveEntryDeviceQueue