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或相应的错误代码。

注解

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

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

要求

要求 值
最低受支持的客户端 在 Microsoft Windows XP 和更高版本的操作系统上可用。 仅当在 Windows 2000 平台上安装了 Microsoft DirectX 9.0 及更高版本时，此例程才在 Windows 2000 平台上可用。
目标平台 桌面
标头 bdasup.h (包括 Bdasup.h)
Library Bdasup.lib
IRQL PASSIVE_LEVEL

另请参阅

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology