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

Статья
02/22/2024

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

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

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

Требования

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