BdaPropertyTemplateConnections 函数 (bdasup.h)

项目
08/07/2023

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 函数返回此数组。