función WDF_IO_QUEUE_STOPPED (wdfio.h)

Artículo
02/29/2024

[Se aplica a KMDF y UMDF]

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

Sintaxis

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

Comentarios

Se detiene una cola de E/S si puede aceptar nuevas solicitudes de E/S, pero el marco no los entrega al controlador.

El controlador puede llamar a WDF_IO_QUEUE_STOPPED 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 detiene una cola de E/S especificada.

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