Função KeInsertQueue (ntifs.h)

Artigo
02/27/2024

A rotina KeInsertQueue insere uma entrada na parte final da fila especificada se não puder usar imediatamente a entrada para atender a uma espera de thread.

Sintaxe

LONG KeInsertQueue(
  [in, out] PRKQUEUE    Queue,
  [in, out] PLIST_ENTRY Entry
);

Parâmetros

[in, out] Queue

Ponteiro para um objeto de fila inicializado para o qual o chamador fornece armazenamento residente em pool nãopagado.

[in, out] Entry

Ponteiro para uma entrada a ser enfileirada. Esse ponteiro deve ser um endereço de espaço do sistema residente.

Retornar valor

KeInsertQueue retorna o estado de sinal anterior da Fila fornecida. Se ele foi definido como zero (ou seja, não sinalizado) antes de KeInsertQueue ser chamado, KeInsertQueue retornará zero, o que significa que nenhuma entrada foi enfileirada. Se não for zero (sinalizado), KeInsertQueue retornará o número de entradas que foram enfileiradas antes de KeInsertQueue ser chamado.

Comentários

As entradas a serem enfileiradas por KeInsertQueue devem ser alocadas do pool nãopagado. Por exemplo, a memória para entradas definidas pelo chamador pode ser alocada com ExAllocatePoolWithTag. Se o chamador alocar entradas de um tamanho fixo, criar uma lista lookaside com ExInitializeNPagedLookasideList e alocar dele com ExAllocateFromNPagedLookasideList será mais eficiente do que fazer chamadas frequentes para ExAllocatePoolWithTag, especialmente para entradas cujo tamanho não é um múltiplo de PAGE_SIZE.

Se algum thread estiver aguardando o objeto de fila quando KeInsertQueue for chamado, a espera de um único thread será atendida por essa chamada. O thread é expedido para execução com o ponteiro entry fornecido.

Se nenhum thread estiver aguardando no objeto de fila quando KeInsertQueue for chamado, a entrada fornecida será inserida na fila e o estado de sinal do objeto de fila será incrementado.

Para obter mais informações sobre como usar filas internas gerenciadas pelo driver, consulte Filas gerenciadas pelo driver.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport)