BdaPropertyNodeDescriptors 函数 （bdasup.h）

BdaPropertyNodeDescriptors 函数检索模板拓扑中的节点列表。

语法

NTSTATUS BdaPropertyNodeDescriptors(
  [in]            PIRP               pIrp,
  [in]            PKSPROPERTY        pKSProperty,
  [out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);

参数

[in] pIrp

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

[in] pKSProperty

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

[out, optional] pNodeDescriptorProperty

指向一个数组，该数组接收模板拓扑中节点的 GUID 列表。

返回值

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

言论

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

有关可用于在模板拓扑中创建的 BDA 节点的列表，请参阅 BDA 节点类别 GUID。

要求

另请参阅

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology