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


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

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

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

Синтаксис

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

Параметры

[in, optional] pDrainComplete

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

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

Никакой

Замечания

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

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

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.5
заголовка wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

См. также

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop