función WDF_IO_QUEUE_PURGED (wdfio.h)
[Se aplica a KMDF y UMDF]
La función WDF_IO_QUEUE_PURGED devuelve TRUE si el estado de una cola de E/S indica que la cola está purgada.
Sintaxis
BOOLEAN WDF_IO_QUEUE_PURGED(
[in] WDF_IO_QUEUE_STATE State
);
Parámetros
[in] State
Valor de tipo WDF_IO_QUEUE_STATE que devuelve WdfIoQueueGetState .
Valor devuelto
WDF_IO_QUEUE_PURGED devuelve TRUE si el estado de cola especificado indica que se purga la cola. De lo contrario, la función devuelve FALSE.
Comentarios
Se purga una cola de E/S si la cola está vacía y no acepta nuevas solicitudes de E/S y si se han cancelado todas las solicitudes que estaban en la cola.
El controlador puede llamar a WDF_IO_QUEUE_PURGED después de llamar a WdfIoQueueGetState.
Para obtener más información sobre los estados de la cola de E/S, consulte WDF_IO_QUEUE_STATE.
Ejemplos
El ejemplo de código siguiente es una rutina que devuelve TRUE si se purga una cola de E/S especificada.
BOOLEAN
IsQueuePurged(
IN WDFQUEUE Queue
)
{
WDF_IO_QUEUE_STATE queueStatus;
queueStatus = WdfIoQueueGetState(
Queue,
NULL,
NULL
);
return (WDF_IO_QUEUE_PURGED(queueStatus)) ? TRUE : FALSE;
}
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfio.h (incluir Wdf.h) |
| Library | None |
| IRQL | Cualquier IRQL. |