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

Статья
08/07/2023

Функция BdaInitFilter инициализирует контекст фильтра BDA, связанный с экземпляром фильтра.

Синтаксис

NTSTATUS BdaInitFilter(
  [in] PKSFILTER                 pKSFilter,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Параметры

[in] pKSFilter

Указывает на фильтр, в котором инициализируется контекст фильтра BDA.

[in] pBdaFilterTemplate

Указывает на структуру BDA_FILTER_TEMPLATE , описывающую шаблон фильтра для устройства BDA. Чтобы определить топологию для и настроить инициализированный фильтр, поставщик сети использует сведения, указанные в этой BDA_FILTER_TEMPLATE структуре.

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

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

Мини-накопитель BDA вызывает функцию BdaInitFilter для инициализации экземпляра фильтра с помощью определенного шаблона фильтра BDA и фабрики фильтров, созданной ранее с помощью вызова функции BdaCreateFilterFactory . Мини-накопитель BDA впоследствии может использовать этот экземпляр фильтра в вызовах других функций поддержки BDA, таких как BdaCreatePin.

Когда мини-драйвер BDA вызывает BdaInitFilter, драйвер поддержки BDA (Bdasup.sys) создает собственный контекст фильтра BDA. Этот контекст фильтра BDA скрыт от мини-драйвера BDA. Однако при необходимости драйвер поддержки BDA может получить доступ к этому контексту фильтра BDA. Драйвер поддержки BDA добавляет указатель на этот контекст фильтра BDA в контейнер объектов для связанного объекта KSFILTER . При уничтожении связанного объекта KSFILTER AVStream запрашивает, чтобы драйвер поддержки BDA удалил этот контекст фильтра BDA из контейнера объектов. Таким образом, драйвер поддержки BDA может уничтожить этот контекст фильтра BDA, не требуя вмешательства мини-драйвера BDA.

Требования

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

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

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER

Поделиться через