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