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

Статья
08/08/2023

[Предупреждение: 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.

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

None

Remarks

Вызов Stop является асинхронным и немедленно возвращается драйверу. Драйвер получает уведомление с помощью метода предоставленного интерфейса IQueueCallbackStateChange после завершения всех невыполненных запросов в драйвере.

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

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

Метод Stop позволяет очереди получать новые запросы, даже если очередь не получала новые запросы до того, как драйвер называется Stop. Например, драйвер может вызвать IWDFIoQueue::D rain, что приводит к прекращению добавления новых запросов ввода-вывода в очередь. Последующий вызов stop драйвера приводит к тому, что платформа возобновляет добавление запросов в очередь.

Требования

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

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

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge

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