IPart：：EnumPartsOutgoing 方法 (devicetopology.h)

  • 项目

EnumPartsOutgoing 方法检索所有传出部件的列表，即驻留在此部件下游的数据路径上的部件。

语法

HRESULT EnumPartsOutgoing(
  [out] IPartsList **ppParts
);

参数

[out] ppParts

指向指针变量的指针，方法将 IPartsList 接口的地址写入其中，该接口封装了紧随此部件下游的部件列表。 通过此方法，调用方获取对 接口的计数引用。 调用方负责通过调用接口的 Release 方法，在不再需要接口时释放接口。 如果 EnumPartsOutgoing 调用失败， 则 *ppParts 为 NULL。

返回值

如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
E_POINTER
 指针 ppParts 为 NULL。
E_NOTFOUND
 此部件没有指向下游部件的链接。
E_OUTOFMEMORY
 内存不足。

注解

客户端应用程序可以通过在遍历中的每个步骤中迭代调用此方法，沿音频数据流的方向遍历设备拓扑，以获取当前部件紧靠下游的部分列表。

如果此部件没有指向下游部件的链接，该方法E_NOTFOUND返回错误代码，并且不会创建部件列表 (*ppParts 为 NULL) 。 例如，如果 IPart 接口表示数据通过该连接器退出设备拓扑，则 方法将返回此错误代码。

有关使用 EnumPartsOutgoing 方法的 代码示例，请参阅 设备拓扑中 SelectCaptureDevice 函数的实现。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

IPart 接口

IPartsList 接口