función WDF_IO_QUEUE_READY (wdfio.h)

Artículo
03/05/2024

[Se aplica a KMDF y UMDF]

La función WDF_IO_QUEUE_READY devuelve TRUE si el estado de una cola de E/S indica que la cola se purga.

Sintaxis

BOOLEAN WDF_IO_QUEUE_READY(
  [in] WDF_IO_QUEUE_STATE State
);

Parámetros

[in] State

Valor con tipo WDF_IO_QUEUE_STATE que devuelve WdfIoQueueGetState .

Valor devuelto

WDF_IO_QUEUE_READY devuelve TRUE si el estado de cola especificado indica que la cola está lista. De lo contrario, la función devuelve FALSE.

Comentarios

Una cola de E/S está lista si la cola puede aceptar y enviar solicitudes de E/S.

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

Para obtener más información sobre los estados de 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á lista.

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