IControlInterface::GetIID method (devicetopology.h)
The GetIID method gets the interface ID of the function-specific control interface of the part.
Syntax
HRESULT GetIID(
[out] GUID *pIID
);
Parameters
[out] pIID
Pointer to a GUID variable into which the method writes the interface ID of the function-specific control interface of the part. For more information, see Remarks.
Return value
If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.
| Return code | Description |
|---|---|
|
Pointer pIID is NULL. |
Remarks
An object that represents a part (connector or subunit) has two control interfaces. The first is a generic control interface, IControlInterface, which has methods that are common to all types of controls. The second is a function-specific control interface that has methods that apply to a particular type of control. The GetIID method gets the interface ID of the second control interface. The client can supply this interface ID to the IPart::Activate method to create an instance of the part's function-specific interface.
The method gets one of the function-specific interface IDs shown in the following table.
| Interface ID | Interface name |
|---|---|
| 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 |
To obtain the interface ID of an interface, use the __uuidof operator. For example, the interface ID of the IAudioAutoGainControl interface is defined as follows:
const IID IID_IAudioAutoGainControl __uuidof(IAudioAutoGainControl)
For more information about the __uuidof operator, see the Windows SDK documentation.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | devicetopology.h |