BdaPropertyTemplateConnections 函数（bdasup.h）

项目
02/06/2025

BdaPropertyTemplateConnections 函数检索一个连接列表，这些连接描述了引脚类型和节点类型在模板拓扑中的连接方式。

语法

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

参数

[in] pIrp

指向请求的 IRP 以检索连接列表。 BDA 微型驱动程序使用 KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 请求接收此 IRP。

[in] pKSProperty

指向描述属性请求的属性和请求类型的 KSPROPERTY 结构。

[out, optional] pConnectionProperty

指向一个数组，该数组接收描述模板拓扑中连接的 KSTOPOLOGY_CONNECTION 结构列表。

返回值

返回STATUS_SUCCESS或适当的错误代码。

言论

BDA 微型驱动程序调用 BdaPropertyTemplateConnections 函数，以在微型驱动程序从网络提供程序收到 KSPROPSETID_BdaTopology 属性集的 KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 请求后检索模板连接列表。大多数 BDA 微型驱动程序都可以定义调度和筛选器自动化表，以便这些微型驱动程序直接调度 BdaPropertyTemplateConnections 函数，而无需使用内部 get-handler 截获此请求（KStrGetPropertyHandler）。有关详细信息，请参阅定义自动化表和确定 BDA 设备拓扑。

当 BDA 微型驱动程序在 BdaCreateFilterFactory 和 BdaInitFilter 函数调用中传递 BDA 筛选器模板（BDA_FILTER_TEMPLATE）时，BDA 微型驱动程序在 KSTOPOLOGY_CONNECTION 结构数组中提供了与 BDA 支持库的连接列表。此数组表示可在筛选器内或筛选器和相邻筛选器之间建立的节点和引脚类型之间的所有可能连接。 BdaPropertyTemplateConnections 函数返回此数组。