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.

Observaciones

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

Si se va a reutilizar el objeto queue, el autor de la llamada debe llamar a KeInitializeQueue después de llamar a KeRundownQueue, con el fin de 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 activa los subprocesos que están esperando actualmente en el objeto de cola con STATUS_ABANDONED. Después de volver de esta función, los subprocesos futuros que intenten esperar en esta cola producirán un error inmediatamente con STATUS_ABANDONED.

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

Para obtener más información sobre el uso de colas internas administradas por controladores, consulte Driver-Managed Queues.

Requisitos

Consulte también

keInitializeQueue

KeRemoveQueue