Partilhar via


Função KeRemoveByKeyDeviceQueue (wdm.h)

A rotina KeRemoveByKeyDeviceQueue remove uma entrada, selecionada de acordo com um valor de chave de classificação, da fila de dispositivos especificada.

Sintaxe

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

Parâmetros

[in, out] DeviceQueue

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

[in] SortKey

Especifica a chave a ser usada ao pesquisar o DeviceQueue.

Valor de retorno

KeRemoveByKeyDeviceQueue retorna a entrada da fila do dispositivo que foi removida; retornará NULL se a fila estiver vazia.

Observações

Essa rotina pesquisa a primeira entrada na fila do dispositivo que tem um valor maior ou igual ao SortKey. Depois que essa entrada é encontrada, essa rotina remove a entrada da fila do dispositivo e a retorna. Se nenhuma entrada desse tipo for encontrada, a primeira entrada na fila será retornada. Se a fila do dispositivo estiver vazia, o dispositivo será definido como um estado não ocupado e um ponteiro NULL será retornado.

É um erro chamar KeRemoveByKeyDeviceQueue quando o objeto de fila do dispositivo é definido como um estado não ocupado.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows 2000.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL DISPATCH_LEVEL
regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)

Consulte também

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue