Функция WdfIoQueueStopAndPurgeSynchronously (wdfio.h)
[Применимо к KMDF и UMDF]
Метод WdfIoQueueStopAndPurgeSynchronous предотвращает доставку новых запросов ввода-вывода и приводит к отмене существующих необработанных запросов и отмененных драйверов, но очередь получает и сохраняет новые запросы.
Синтаксис
void WdfIoQueueStopAndPurgeSynchronously(
[in] WDFQUEUE Queue
);
Параметры
[in] Queue
Дескриптор объекта очереди платформы.
Возвращаемое значение
Нет
Замечания
Этот метод возвращается после завершения или отмены всех необработанных и управляемых драйвером запросов (не включая запросы, добавленные в очередь после этого вызова). Если новые запросы вставляются во время выполнения WdfIoQueueStopAndPurgeSynchronous, эти новые запросы не доставляются до тех пор, пока драйвер не вызывает WdfIoQueueStart.
Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | универсальный |
| минимальная версия KMDF | 1.11 |
| минимальная версия UMDF | 2.0 |
| Заголовок | wdfio.h (include Wdf.h) |
| Библиотека | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |