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

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

WDF_IO_QUEUE_DRAINED

WDF_IO_QUEUE_IDLE

WDF_IO_QUEUE_READY

WDF_IO_QUEUE_STOPPED