Функция WdfIoQueueStopAndPurgeSynchronously (wdfio.h)

[Относится к KMDF и UMDF]

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

Синтаксис

void WdfIoQueueStopAndPurgeSynchronously(
  [in] WDFQUEUE Queue
);

Параметры

[in] Queue

Дескриптор объекта очереди платформы.

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

None

Remarks

Этот метод возвращается после завершения или отмены всех необработанных запросов и запросов, принадлежащих драйверу (не включая запросы, добавленные в очередь после выполнения этого вызова). Если новые запросы вставляются во время выполнения WdfIoQueueStopAndPurgeSynchronously , эти новые запросы не доставляются до тех пор, пока драйвер не вызовет WdfIoQueueStart.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.11
Минимальная версия UMDF 2,0
Верхняя часть wdfio.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Правила соответствия DDI ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf)

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

WdfIoQueueStopAndPurge