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

Статья
08/07/2023

Функция 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 или соответствующий код ошибки.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версий.
Целевая платформа	Персональный компьютер
Верхняя часть	bdasup.h (включая Bdasup.h)
Библиотека	Bdasup.lib
IRQL	PASSIVE_LEVEL