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

Статья
02/06/2025

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

Синтаксис

NTSTATUS BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

Параметры

[in] pKSDevice

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

[in] pFilterDescriptor

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

[in] pBdaFilterTemplate

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

[out, optional] ppKSFilterFactory

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

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

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

Замечания

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

Мини-driver BDA вызывает BdaCreateFilterFactoryExвместо функции BdaCreateFilterFactory, когда требуется указатель на только что созданный KSFILTERFACTORY. Функция BdaCreateFilterFactory также создает фабрику фильтров, но не возвращает ее вызывающему объекту. Для мини-driver BDA требуется указатель на только что созданный KSFILTERFACTORY, если мини-driver должен вызвать функцию _KsEdit для изменения KSFILTERFACTORY.

Требования

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