Função KeInsertByKeyDeviceQueue (wdm.h)
A rotina KeInsertByKeyDeviceQueue adquire o bloqueio de rotação para o DeviceQueue especificado e enfileira uma entrada de acordo com o valor de chave de classificação especificado se a fila do dispositivo estiver definida como um estado ocupado.
Sintaxe
BOOLEAN KeInsertByKeyDeviceQueue(
[in, out] PKDEVICE_QUEUE DeviceQueue,
[in, out] PKDEVICE_QUEUE_ENTRY DeviceQueueEntry,
[in] ULONG SortKey
);
Parâmetros
[in, out] DeviceQueue
Ponteiro para um objeto de controle do tipo de fila do dispositivo para o qual o chamador fornece o armazenamento.
[in, out] DeviceQueueEntry
Ponteiro para a entrada da fila do dispositivo a ser inserida na fila do dispositivo de acordo com o valor de chave específico.
[in] SortKey
Especifica o valor da chave de classificação que determina a posição na fila do dispositivo na qual inserir a entrada.
Retornar valor
Se a fila do dispositivo estiver vazia, FALSE será retornado, o que significa que DeviceQueueEntry não está inserido na fila do dispositivo.
Comentários
O bloqueio de rotação da fila do dispositivo especificado é adquirido e o estado da fila do dispositivo é verificado. Se a fila do dispositivo estiver definida como um estado ocupado, o IRP especificado pelo DeviceQueueEntry será inserido na fila do dispositivo de acordo com seu valor de chave de classificação e o bloqueio de rotação da fila do dispositivo será liberado.
A nova entrada é posicionada na fila do dispositivo após todas as entradas na fila com valores de chave de classificação menores ou iguais ao seu valor de chave de classificação e precedendo todas as entradas com valores de chave de classificação maiores.
Se KeInsertByKeyDeviceQueue retornar FALSE, o chamador deverá começar a processar o IRP. Uma chamada para KeInsertDeviceQueue ou KeInsertByKeyDeviceQueue quando a fila está vazia faz com que a fila do dispositivo faça a transição de um estado não ocupado para um estado ocupado.
Essa rotina é para o código que enfileira uma solicitação de E/S para um driver de dispositivo.
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 da DDI | HwStorPortProhibitedDDIs(storport), IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm), MarkingQueuedIrps(wdm) |