funzione WDF_IO_QUEUE_PURGED (wdfio.h)
[Si applica a KMDF e UMDF]
La funzione WDF_IO_QUEUE_PURGED restituisce TRUE se lo stato di una coda di I/O indica che la coda viene svuotata.
Sintassi
BOOLEAN WDF_IO_QUEUE_PURGED(
[in] WDF_IO_QUEUE_STATE State
);
Parametri
[in] State
Valore WDF_IO_QUEUE_STATE tipizzato restituito da WdfIoQueueGetState .
Valore restituito
WDF_IO_QUEUE_PURGED restituisce TRUE se lo stato della coda specificato indica che la coda viene eliminata. In caso contrario, la funzione restituisce FALSE.
Commenti
Una coda di I/O viene eliminata se la coda è vuota e non accetta le nuove richieste di I/O e se tutte le richieste presenti nella coda sono state annullate.
Il driver può chiamare WDF_IO_QUEUE_PURGED 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 eliminata una coda di I/O specificata.
BOOLEAN
IsQueuePurged(
IN WDFQUEUE Queue
)
{
WDF_IO_QUEUE_STATE queueStatus;
queueStatus = WdfIoQueueGetState(
Queue,
NULL,
NULL
);
return (WDF_IO_QUEUE_PURGED(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. |