Função KeRundownQueue (ntifs.h)

  • Artigo

A rotina KeRundownQueue limpa um objeto de fila, liberando todas as entradas enfileiradas.

Sintaxe

PLIST_ENTRY KeRundownQueue(
  [in, out] PRKQUEUE Queue
);

Parâmetros

[in, out] Queue

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

Retornar valor

Se a fila estiver vazia, KeRundownQueue retornará NULL; caso contrário, ele retorna o endereço da primeira entrada na fila.

Comentários

Os sistemas de arquivos chamam KeRundownQueue para descartar todas as entradas de uma fila antes de liberar ou reutilizá-lo.

Se o objeto de fila for reutilizado, o chamador deverá chamar KeInitializeQueue depois de chamar KeRundownQueue, a fim de reinicializar o objeto de fila antes de reutilizá-lo.

KeRundownQueue não retorna informações sobre quantas entradas enfileiradas são descartadas.

A partir do Windows 7, KeRundownQueue ativa todos os threads que estão aguardando no objeto de fila com STATUS_ABANDONED. Depois de retornar dessa função, todos os threads futuros que tentarem aguardar nessa fila falharão imediatamente com STATUS_ABANDONED.

Antes do Windows 7, KeRundownQueue não acordava threads de espera quando a fila era degradada. Para evitar a possibilidade de deixar threads esperando para sempre nessas versões do sistema operacional, KeRundownQueue nunca deverá ser chamado para uma fila se algum thread estiver esperando no objeto de fila.

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

Confira também

KeInitializeQueue

KeRemoveQueue