IPart：：GetTopologyObject 方法 (devicetopology.h)

GetTopologyObject 方法获取对包含此部件的设备拓扑对象的 IDeviceTopology 接口的引用。

语法

HRESULT GetTopologyObject(
  [out] IDeviceTopology **ppTopology
);

参数

[out] ppTopology

指向指针变量的指针，方法在其中写入 device-topology 对象的 IDeviceTopology 接口的地址。 调用方从此方法获取对 接口的计数引用。 通过此方法，调用方获取对 接口的计数引用。 调用方负责通过调用接口的 Release 方法，在不再需要接口时释放接口。 如果 GetTopologyObject 调用失败， 则 *ppTopology 为 NULL。

返回值

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

返回代码	说明
E_POINTER	指针 ppTopology 为 NULL。

备注

有关使用此方法的代码示例，请参阅以下主题：

• 设备拓扑
• 使用 IKsControl 接口访问音频属性

要求

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

另请参阅

IDeviceTopology 接口

IPart 接口