función WDF_IO_QUEUE_DRAINED (wdfio.h)

Artículo
02/29/2024

[Se aplica a KMDF y UMDF]

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

Sintaxis

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [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_DRAINED devuelve TRUE si el estado de cola especificado indica que la cola está purgada. De lo contrario, la función devuelve FALSE.

Comentarios

Una cola de E/S se purga si no acepta nuevas solicitudes de E/S y si todas las solicitudes que estaban en la cola se han entregado al controlador.

El controlador puede llamar a WDF_IO_QUEUE_DRAINED 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
IsQueueDrained(
    IN WDFQUEUE Queue
    )
{
    WDF_IO_QUEUE_STATE queueStatus;
    queueStatus = WdfIoQueueGetState(
                                     Queue,
                                     NULL,
                                     NULL
                                     );
    return (WDF_IO_QUEUE_DRAINED(queueStatus)) ? TRUE : FALSE;
}