функция 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.

См. также раздел

WDF_IO_QUEUE_IDLE

WDF_IO_QUEUE_PURGED

WDF_IO_QUEUE_READY

WDF_IO_QUEUE_STOPPED