iPart 接口 (devicetopology.h)

IPart 接口表示设备拓扑的部件 (连接器或子单元) 。 客户端通过调用 IDeviceTopology：：GetPartById 或 IPartsList：：GetPart 方法，或通过在部件对象上调用 IConnector 或 ISubunit 接口的 QueryInterface 方法，并将方法的 iid 参数设置为 REFIID IID_IPart来获取对 IPart 接口的引用。

具有 IPart 接口的对象可以封装以下设备拓扑部件之一：

• 连接。 这是连接到另一台设备以形成数据路径的部件，用于在设备之间传输音频流。
• 亚基。 这是处理音频流的部件， (例如音量控制) 。

连接器或子单元对象的 IPart 接口表示所有部件通用的泛型函数，对象的 IConnector 或 ISubunit 接口表示特定于连接器或子单元的函数。 此外，部件可能支持一个或多个控制接口来控制或监视部件的功能。 例如，客户端通过其 IAudioVolumeLevel 接口控制卷控制子单元。

IPart 接口提供用于获取连接器或子单元的名称、本地 ID、全局 ID 和部件类型的方法。 此外， IPart 可以在连接器或子单元上激活控件接口。

有关使用 IPart 接口的代码示例，请参阅 设备拓扑中 GetHardwareDeviceTopology 和 SelectCaptureDevice 函数的实现。

继承

IPart 接口继承自 IUnknown 接口。 IPart 还具有以下类型的成员：

方法

IPart 接口具有这些方法。

IPart：：Activate Activate 方法在连接器或子单元上激活特定于函数的接口。
IPart：：EnumPartsIncoming EnumPartsIncoming 方法获取所有传入部件的列表，即驻留在此部件上游的数据路径上的部分。
IPart：：EnumPartsOutgoing EnumPartsOutgoing 方法检索所有传出部件的列表，即驻留在此部件下游的数据路径上的部分。
IPart：：GetControlInterface GetControlInterface 方法获取对指定控件接口的引用（如果此部分支持）。
IPart：：GetControlInterfaceCount GetControlInterfaceCount 方法获取此部件支持的控件接口数。
IPart：：GetGlobalId GetGlobalId 方法获取此部件的全局 ID。
IPart：：GetLocalId GetLocalId 方法获取此部件的本地 ID。
IPart：：GetName GetName 方法获取此部件的友好名称。
IPart：：GetPartType GetPartType 方法获取此部件的部件类型。
IPart：：GetSubType GetSubType 方法获取此部件的部件子类型。
IPart：：GetTopologyObject GetTopologyObject 方法获取对包含此部分的设备拓扑对象的 IDeviceTopology 接口的引用。
IPart：：RegisterControlChangeCallback RegisterControlChangeCallback 方法注册 IControlChangeNotify 接口，客户端实现该接口以接收此部分中的状态更改通知。
IPart：：UnregisterControlChangeCallback UnregisterControlChangeCallback 方法删除客户端之前通过调用 IPart：：RegisterControlChangeCallback 方法注册的 IControlChangeNotify 接口的注册。

要求

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

另请参阅

核心音频接口

DeviceTopology API

IAudioVolumeLevel 接口

IConnector 接口

IDeviceTopology：：GetPartById

IPartsList：：GetPart

ISubunit 接口