Функция 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) |