Функция BdaInitFilter (bdasup.h)
Функция 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 или соответствующий код ошибки.
Замечания
Мини-driver BDA вызывает функцию BdaInitFilter для инициализации экземпляра фильтра с помощью определенного шаблона фильтра BDA и фабрики фильтров, созданной ранее с помощью вызова функции BdaCreateFilterFactory. Мини-driver BDA впоследствии может использовать этот экземпляр фильтра в вызовах других функций поддержки BDA, таких как BdaCreatePin.
При вызове мини-driver BDA BdaInitFilterдрайвер поддержки BDA (Bdasup.sys) создает собственный контекст фильтра BDA. Этот контекст фильтра BDA скрыт из мини-driver BDA. Однако при необходимости драйвер поддержки BDA может получить доступ к этому контексту фильтра BDA. Драйвер поддержки BDA добавляет указатель в этот контекст фильтра BDA в контейнер объектов для связанного объекта объекта KSFILTER. При уничтожении связанного объекта KSFILTER AVStream запрашивает, чтобы драйвер поддержки BDA удалил этот контекст фильтра BDA из контейнера объектов. Таким образом, драйвер поддержки BDA может уничтожить этот контекст фильтра BDA, не требуя вмешательства мини-driver BDA.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в операционных системах Microsoft Windows XP и более поздних версий. Эта подпрограмма доступна на платформе Windows 2000 только в том случае, если на этой платформе установлен Microsoft DirectX 9.0 и более поздних версий. |
| целевая платформа | Настольный |
| заголовка | bdasup.h (include Bdasup.h) |
| библиотеки | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |