funzione WDF_IO_QUEUE_DRAINED (wdfio.h)

Articolo
03/22/2025

[Si applica a KMDF e UMDF]

La funzione WDF_IO_QUEUE_DRAINED restituisce TRUE se lo stato della coda di I/O indica che la coda è svuotata.

Sintassi

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

Parametri

[in] State

Valore WDF_IO_QUEUE_STATEtipizzato restituito WdfIoQueueGetState.

Valore restituito

WDF_IO_QUEUE_DRAINED restituisce true se lo stato della coda specificato indica che la coda è svuotata. In caso contrario, la funzione restituisce FALSE.

Osservazioni:

Una coda di I/O viene svuotata se non accetta nuove richieste di I/O e se tutte le richieste presenti nella coda sono state recapitate al driver.

Il driver può chiamare WDF_IO_QUEUE_DRAINED dopo aver chiamato WdfIoQueueGetState.

Per altre informazioni sugli stati della coda di I/O, vedere WDF_IO_QUEUE_STATE.

Esempi

L'esempio di codice seguente è una routine che restituisce TRUE se viene svuotata una coda di I/O specificata.

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfio.h (include Wdf.h)
Biblioteca	Nessuno
IRQL	Qualsiasi IRQL.

Vedere anche

Condividi tramite