função WDF_IO_QUEUE_DRAINED (wdfio.h)

Artigo
02/27/2024

[Aplica-se a KMDF e UMDF]

A função WDF_IO_QUEUE_DRAINED retornará TRUE se o estado da fila de E/S indicar que a fila está drenada.

Sintaxe

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

Parâmetros

[in] State

Um valor de tipo WDF_IO_QUEUE_STATE que WdfIoQueueGetState retorna.

Retornar valor

WDF_IO_QUEUE_DRAINEDretornará TRUE se o estado da fila especificado indicar que a fila está drenada. Caso contrário, a função retornará FALSE.

Comentários

Uma fila de E/S será esvaziada se não estiver aceitando novas solicitações de E/S e se todas as solicitações que estavam na fila tiverem sido entregues ao driver.

Seu driver pode chamar WDF_IO_QUEUE_DRAINED depois de chamar WdfIoQueueGetState.

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

Exemplos

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

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