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