iPart 接口 (devicetopology.h)
IPart 接口表示设备拓扑的部件 (连接器或子单元) 。 客户端通过调用 IDeviceTopology::GetPartById 或 IPartsList::GetPart 方法,或通过在部件对象上调用 IConnector 或 ISubunit 接口的 QueryInterface 方法,并将方法的 iid 参数设置为 REFIID IID_IPart来获取对 IPart 接口的引用。
具有 IPart 接口的对象可以封装以下设备拓扑部件之一:
- 连接。 这是连接到另一台设备以形成数据路径的部件,用于在设备之间传输音频流。
- 亚基。 这是处理音频流的部件, (例如音量控制) 。
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 |