Função KeRundownQueue (ntifs.h)
A rotina KeRundownQueue limpa um objeto de fila, liberando todas as entradas na fila.
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 no pool nãopagado.
Valor de retorno
Se a fila estiver vazia, KeRundownQueue retornará NULL; caso contrário, ele retorna o endereço da primeira entrada na fila.
Observações
Os sistemas de arquivos chamam KeRundownQueue descartar todas as entradas de uma fila antes de liberar ou reutilização do objeto de fila.
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 atualmente 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 ativava threads de espera quando a fila era executada. 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 Driver-Managed Filas.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |