Função KeRundownQueue (ntifs.h)
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 |