IControlInterface：：GetIID 方法 (devicetopology.h)

  • 项目

GetIID 方法获取部件的特定于函数的控件接口的接口 ID。

语法

HRESULT GetIID(
  [out] GUID *pIID
);

参数

[out] pIID

指向 GUID 变量的指针，方法在该变量中写入部件的特定于函数的控件接口的接口 ID。 有关详细信息，请参阅“备注”。

返回值

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

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

注解

表示部件 (连接器或子单元) 的对象有两个控制接口。 第一个是泛型控件接口 IControlInterface，它具有所有类型的控件通用的方法。 第二个是特定于函数的控件接口，该接口具有应用于特定类型的控件的方法。 GetIID 方法获取第二个控件接口的接口 ID。 客户端可以将此接口 ID 提供给 IPart：：Activate 方法，以创建部件的特定于函数的接口的实例。

方法获取下表所示的特定于函数的接口 ID 之一。

接口 ID 接口名称
IID_IAudioAutoGainControl IAudioAutoGainControl
IID_IAudioBass IAudioBass
IID_IAudioChannelConfig IAudioChannelConfig
IID_IAudioInputSelector IAudioInputSelector
IID_IAudioLoudness IAudioLoudness
IID_IAudioMidrange IAudioMidrange
IID_IAudioMute IAudioMute
IID_IAudioOutputSelector IAudioOutputSelector
IID_IAudioPeakMeter IAudioPeakMeter
IID_IAudioTreble IAudioTreble
IID_IAudioVolumeLevel IAudioVolumeLevel
IID_IDeviceSpecificProperty IDeviceSpecificProperty
IID_IKsFormatSupport IKsFormatSupport
IID_IKsJackDescription IKsJackDescription
 

若要获取接口的接口 ID，请使用 __uuidof 运算符。 例如， IAudioAutoGainControl 接口的接口 ID 定义如下：


const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

有关 __uuidof 运算符的详细信息，请参阅Windows SDK文档。

要求

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

另请参阅

IControlInterface 接口