Função KeRemoveEntryDeviceQueue (wdm.h)

  • Artigo

A rotina KeRemoveEntryDeviceQueue retorna se a entrada especificada está na fila do dispositivo e a remove, se foi enfileirada, da fila do dispositivo.

Sintaxe

BOOLEAN KeRemoveEntryDeviceQueue(
  [in, out] PKDEVICE_QUEUE       DeviceQueue,
  [in, out] PKDEVICE_QUEUE_ENTRY DeviceQueueEntry
);

Parâmetros

[in, out] DeviceQueue

Ponteiro para um objeto de fila de dispositivo inicializado para o qual o chamador fornece o armazenamento.

[in, out] DeviceQueueEntry

Ponteiro para a entrada a ser removida do DeviceQueue especificado.

Retornar valor

Se DeviceQueueEntry estiver na fila, ela será removida e KeRemoveEntryDeviceQueue retornará TRUE.

Comentários

O IRQL é definido como DISPATCH_LEVEL e o bloqueio de rotação DeviceQueue é adquirido.

Se o DeviceQueueEntry especificado não estiver na fila, o IRP já está sendo processado ou o IRP foi cancelado. Nesse caso, KeRemoveEntryDeviceQueue simplesmente retorna FALSE.

O bloqueio de rotação DeviceQueue especificado é liberado e IRQL é restaurado para seu valor anterior.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)

Confira também

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveByKeyDeviceQueue

KeRemoveDeviceQueue