функция WDF_IO_QUEUE_PURGED (wdfio.h)
[Относится к KMDF и UMDF]
Функция WDF_IO_QUEUE_PURGED возвращает значение TRUE , если состояние очереди ввода-вывода указывает на то, что очередь истощается.
Синтаксис
BOOLEAN WDF_IO_QUEUE_PURGED(
[in] WDF_IO_QUEUE_STATE State
);
Параметры
[in] State
Значение типа WDF_IO_QUEUE_STATE, возвращаемое WdfIoQueueGetState.
Возвращаемое значение
WDF_IO_QUEUE_PURGED возвращает значение TRUE , если указанное состояние очереди указывает на очистку очереди. В противном случае функция возвращает значение FALSE.
Комментарии
Очередь ввода-вывода очищается, если очередь пуста и не принимает новые запросы ввода-вывода, а также если все запросы, которые находились в очереди, были отменены.
Драйвер может вызывать WDF_IO_QUEUE_PURGED после вызова WdfIoQueueGetState.
Дополнительные сведения о состояниях очереди ввода-вывода см. в разделе WDF_IO_QUEUE_STATE.
Примеры
Следующий пример кода представляет собой подпрограмму, которая возвращает значение TRUE при очистке указанной очереди ввода-вывода.
BOOLEAN
IsQueuePurged(
IN WDFQUEUE Queue
)
{
WDF_IO_QUEUE_STATE queueStatus;
queueStatus = WdfIoQueueGetState(
Queue,
NULL,
NULL
);
return (WDF_IO_QUEUE_PURGED(queueStatus)) ? TRUE : FALSE;
}
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfio.h (включая Wdf.h) |
| Библиотека | None |
| IRQL | Любой IRQL. |