IControlInterface::GetIID 方法 (devicetopology.h)
GetIID 方法获取部件的特定于函数的控件接口的接口 ID。
语法
HRESULT GetIID(
[out] GUID *pIID
);
参数
[out] pIID
指向 GUID 变量的指针,方法在该变量中写入部件的特定于函数的控件接口的接口 ID。 有关详细信息,请参阅“备注”。
返回值
如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
指针 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 |