funzione WDF_IO_QUEUE_DRAINED (wdfio.h)

Articolo
02/27/2024

[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 viene svuotata.

Sintassi

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

Parametri

[in] State

Valore WDF_IO_QUEUE_STATE tipizzato restituito da WdfIoQueueGetState .

Valore restituito

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

Commenti

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.

Esempio

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 KMDF minima	1.0
Intestazione	wdfio.h (includere Wdf.h)
Libreria	Nessuno
IRQL	Qualsiasi IRQL.

Vedi anche