Функция BdaCreateFilterFactory (bdasup.h)

Статья
02/06/2025

Функция BdaCreateFilterFactory добавляет указанный дескриптор фильтра в качестве фабрики фильтров на указанное устройство и связывает фабрику фильтров с указанной топологией шаблона BDA.

Синтаксис

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Параметры

[in] pKSDevice

Указывает на устройство BDA, к которому добавляется фабрика фильтров с связанной топологией шаблона BDA.

[in] pFilterDescriptor

Указывает на структуру KSFILTER_DESCRIPTOR, описывающую фильтр для устройства BDA. Обратите внимание, что при инициализации фильтра не все типы закреплений шаблона и узлов могут быть представлены как пин-код и фабрики узлов.

[in] pBdaFilterTemplate

Указывает на структуру BDA_FILTER_TEMPLATE, описывающую топологию шаблона BDA.

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

Возвращает STATUS_SUCCESS или соответствующий код ошибки.

Замечания

Мини-driver BDA вызывает функцию BdaCreateFilterFactory, чтобы добавить фабрику фильтров с связанной топологией шаблона BDA на устройство и зарегистрировать все статические структуры шаблонов топологии в библиотеке поддержки BDA (BdaSup.sys). Затем библиотека поддержки BDA может обрабатывать следующие вызовы методов и свойств:

Если мини-driver BDA требует указатель на только что созданную фабрику фильтров (KSFILTERFACTORY), мини-driver должен вызывать функцию BdaCreateFilterFactoryEx.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в операционных системах Microsoft Windows XP и более поздних версий.
целевая платформа	Настольный
заголовка	bdasup.h (include Bdasup.h)
библиотеки	Bdasup.lib
IRQL	PASSIVE_LEVEL