Función KeRundownQueue (ntifs.h)

La rutina KeRundownQueue limpia un objeto de cola y vacía las entradas en cola.

Sintaxis

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

Parámetros

[in, out] Queue

Puntero a un objeto de cola inicializado para el que el autor de la llamada proporciona almacenamiento residente en un grupo no paginado.

Valor devuelto

Si la cola está vacía, KeRundownQueue devuelve NULL; de lo contrario, devuelve la dirección de la primera entrada de la cola.

Comentarios

Los sistemas de archivos llaman a KeRundownQueue para descartar todas las entradas de una cola antes de liberar o reutilizar el objeto de cola.

Si se va a reutilizar el objeto de cola, el autor de la llamada debe llamar a KeInitializeQueue después de llamar a KeRundownQueue, para reinicializar el objeto de cola antes de reutilizarlo.

KeRundownQueue no devuelve información sobre cuántas entradas en cola se descartan.

A partir de Windows 7, KeRundownQueue reactiva los subprocesos que están esperando actualmente en el objeto de cola con STATUS_ABANDONED. Después de volver de esta función, los futuros subprocesos que intenten esperar en esta cola producirán un error inmediatamente con STATUS_ABANDONED.

Antes de Windows 7, KeRundownQueue no despertaba los subprocesos en espera cuando la cola estaba en ejecución. Para evitar la posibilidad de dejar subprocesos esperando indefinidamente en estas versiones del sistema operativo, nunca se debe llamar a KeRundownQueue para una cola si algún subproceso está esperando en el objeto de cola.

Para más información sobre el uso de colas internas administradas por controladores, consulte Colas administradas por controladores.

Requisitos

Consulte también

KeInitializeQueue

KeRemoveQueue