Метод IWDFIoQueue::Stop (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Метод stop предотвращает доставку запросов ввода-вывода очереди ввода-вывода, но очередь получает и сохраняет новые запросы.
Синтаксис
void Stop(
[in, optional] IQueueCallbackStateChange *pStopComplete
);
Параметры
[in, optional] pStopComplete
Указатель на интерфейс IQueueCallbackStateChange, метод которого вызывает платформу после всех невыполненных запросов ввода-вывода( при наличии) в драйвере. Этот параметр является необязательным и может быть null.
Возвращаемое значение
Никакой
Замечания
Вызов остановки является асинхронным и немедленно возвращается драйверу. Драйвер уведомляется с помощью метода предоставленного интерфейса IQueueCallbackStateChange после завершения всех невыполненных запросов в драйвере.
Драйвер должен убедиться, что в любое время выполняется только один из следующих методов:
- IWDFIoQueue::Stop
Метод Stop позволяет очереди получать новые запросы, даже если очередь не получает новые запросы до вызова драйвера Stop. Например, драйвер может вызывать IWDFIoQueue::D rain, что приводит к остановке добавления новых запросов ввода-вывода в очередь. Последующий вызов драйвера stop приводит к возобновлению добавления запросов в очередь платформы.
Требования
Требование | Ценность |
---|---|
завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
целевая платформа | Настольный |
минимальная версия UMDF | 1.5 |
заголовка | wudfddi.h (include Wudfddi.h) |
DLL | WUDFx.dll |