funzione WDF_IO_QUEUE_IDLE (wdfio.h)

[Si applica a KMDF e UMDF]

La funzione WDF_IO_QUEUE_IDLE restituisce TRUE se lo stato di una coda di I/O indica che la coda viene svuotata.

Sintassi

BOOLEAN WDF_IO_QUEUE_IDLE(
  [in] WDF_IO_QUEUE_STATE State
);

Parametri

[in] State

Valore WDF_IO_QUEUE_STATE tipizzato restituito da WdfIoQueueGetState .

Valore restituito

WDF_IO_QUEUE_IDLE restituisce TRUE se lo stato della coda specificato indica che la coda è inattiva. In caso contrario, la funzione restituisce FALSE.

Commenti

Una coda di I/O è inattiva se la coda non contiene richieste di I/O e se tutte le richieste recapitate sono state completate o annullate.

Il driver può chiamare WDF_IO_QUEUE_IDLE 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 una coda di I/O specificata è inattiva.

BOOLEAN
IsQueueIdle(
    IN WDFQUEUE Queue
    )
{
    WDF_IO_QUEUE_STATE queueStatus;
    queueStatus = WdfIoQueueGetState(
                                     Queue,
                                     NULL,
                                     NULL
                                     );
    return (WDF_IO_QUEUE_IDLE(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

WDF_IO_QUEUE_DRAINED

WDF_IO_QUEUE_PURGED

WDF_IO_QUEUE_READY

WDF_IO_QUEUE_STOPPED