Поделиться через

Метод IWDFIoQueue::D rain (wudfddi.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Метод Drain направляет очередь на отклонение новых входящих запросов ввода-вывода и разрешение на доставку уже помещенных в очередь запросов драйверу для обработки.

Синтаксис

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

Параметры

[in, optional] pDrainComplete

Указатель на интерфейс IQueueCallbackStateChange , метод которого платформа вызывает для доставки состояния очереди драйверу. Платформа вызывает метод после завершения или отмены всех запросов, а очередь пуста. Этот параметр является необязательным и может иметь значение NULL.

Возвращаемое значение

None

Remarks

Драйвер должен гарантировать, что в любой момент времени выполняется только один из следующих методов:

Например, если драйвер ранее назывался Drain, он должен дождаться уведомления от метода интерфейса, на который указывает параметр pDrainComplete , прежде чем драйвер вызывает Stop или Purge. Нарушение этого правила приводит к завершению хост-процесса.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfddi.h (включая Wudfddi.h)
DLL WUDFx.dll

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

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop