Метод 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.

Требования

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

IWDFDeviceInitialize

IWDFDriver::CreateDevice