função WDF_IO_QUEUE_STOPPED (wdfio.h)

Artigo
03/22/2025

[Aplica-se a KMDF e UMDF]

A função WDF_IO_QUEUE_STOPPED retornará verdadeiro se o estado de uma fila de E/S indicar que a fila foi interrompida.

Sintaxe

BOOLEAN WDF_IO_QUEUE_STOPPED(
  [in] WDF_IO_QUEUE_STATE State
);

Parâmetros

[in] State

Um valor WDF_IO_QUEUE_STATEdigitado que WdfIoQueueGetState retorna.

Valor de retorno

WDF_IO_QUEUE_STOPPED retorna VERDADEIRO se o estado da fila especificado indicar que a fila foi interrompida. Caso contrário, a função retornará FALSE.

Observações

Uma fila de E/S será interrompida se puder aceitar novas solicitações de E/S, mas a estrutura não as estiver entregando ao driver.

O driver pode chamar WDF_IO_QUEUE_STOPPED depois de chamar WdfIoQueueGetState.

Para obter mais informações sobre estados de fila de E/S, consulte WDF_IO_QUEUE_STATE.

Exemplos

O exemplo de código a seguir é uma rotina que retorna verdadeiro se uma fila de E/S especificada for interrompida.

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