función WDF_IO_QUEUE_PURGED (wdfio.h)

Artículo
02/29/2024

[Se aplica a KMDF y UMDF]

La función WDF_IO_QUEUE_PURGED devuelve TRUE si el estado de una cola de E/S indica que la cola está purgada.

Sintaxis

BOOLEAN WDF_IO_QUEUE_PURGED(
  [in] WDF_IO_QUEUE_STATE State
);

Parámetros

[in] State

Valor de tipo WDF_IO_QUEUE_STATE que devuelve WdfIoQueueGetState .

Valor devuelto

WDF_IO_QUEUE_PURGED devuelve TRUE si el estado de cola especificado indica que se purga la cola. De lo contrario, la función devuelve FALSE.

Comentarios

Se purga una cola de E/S si la cola está vacía y no acepta nuevas solicitudes de E/S y si se han cancelado todas las solicitudes que estaban en la cola.

El controlador puede llamar a WDF_IO_QUEUE_PURGED después de llamar a WdfIoQueueGetState.

Para obtener más información sobre los estados de la cola de E/S, consulte WDF_IO_QUEUE_STATE.

Ejemplos

El ejemplo de código siguiente es una rutina que devuelve TRUE si se purga una cola de E/S especificada.

BOOLEAN
IsQueuePurged(
    IN WDFQUEUE Queue
    )
{
    WDF_IO_QUEUE_STATE queueStatus;
    queueStatus = WdfIoQueueGetState(
                                     Queue,
                                     NULL,
                                     NULL
                                     );
    return (WDF_IO_QUEUE_PURGED(queueStatus)) ? TRUE : FALSE;
}