función WDF_IO_QUEUE_IDLE (wdfio.h)

Artículo
02/27/2024

[Se aplica a KMDF y UMDF]

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

Sintaxis

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

Comentarios

Una cola de E/S está inactiva si la cola no contiene solicitudes de E/S y si todas las solicitudes entregadas se han completado o cancelado.

El controlador puede llamar a WDF_IO_QUEUE_IDLE 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 una cola de E/S especificada está inactiva.

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