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

Статья
02/22/2024

Функция BdaPropertyTemplateConnections извлекает список подключений, описывающих, как типы контактов и типы узлов связаны в топологии шаблона.

Синтаксис

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

Параметры

[in] pIrp

Указывает на IRP для запроса на получение списка подключений. Мини-диск BDA получает этот IRP с запросом KSPROPERTY_BDA_TEMPLATE_CONNECTIONS .

[in] pKSProperty

Указывает на структуру KSPROPERTY , описывающую свойство и тип запроса свойства.

[out, optional] pConnectionProperty

Указывает на массив, получающий список KSTOPOLOGY_CONNECTION структур, описывающих подключения в топологии шаблона.

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

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

Мини-накопитель BDA вызывает функцию BdaPropertyTemplateConnections , чтобы получить список подключений шаблонов после того, как мини-накопитель получит KSPROPERTY_BDA_TEMPLATE_CONNECTIONS запрос свойства KSPROPSETID_BdaTopology , заданного от поставщика сети. Большинство мини-драйверов BDA могут определять таблицы диспетчеризации и автоматизации фильтрации, чтобы эти мини-драйверы отправляли функцию BdaPropertyTemplateConnections напрямую, не перехватывая этот запрос с помощью внутреннего обработчика get (KStrGetPropertyHandler). Дополнительные сведения см. в разделах Определение таблиц автоматизации и Определение топологии устройств BDA .

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

Требования

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