Метод IWDFDeviceInitialize::SetFilter (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]
Метод SetFilter задает свойство, которое позволяет использовать устройство в качестве устройства фильтра.
Синтаксис
void SetFilter();
Возвращаемое значение
None
Remarks
Драйвер фильтра вызывает SetFilter , чтобы пометить себя как фильтр. Когда вы сообщаете платформе, что ваш драйвер является фильтром, платформа:
- Отправляет запросы ввода-вывода, для которых фильтр не зарегистрировал обратный вызов к следующему логическому драйверу в стеке. Например, драйвер фильтра предоставляет метод IQueueCallbackDeviceIoControl::OnDeviceIoControl , но не IQueueCallbackRead::OnRead или IQueueCallbackWrite::OnWrite. В результате драйвер фильтра получает только запросы на управление вводом-выводом устройства.
- Автоматически пересылает запросы на создание, очистку и закрытие файлов, чтобы драйверу не нужно вызывать метод IWDFDeviceInitialize::AutoForwardCreateCleanupClose .
Примеры
Пример кода использования метода SetFilter см. в разделе IWDFDriver::CreateDevice.
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1.5 |
| Верхняя часть | wudfddi.h (включая Wudfddi.h) |
| DLL | WUDFx.dll |