Share via


IControlInterface::GetIID

Previous Next

IControlInterface::GetIID

The GetIID method gets the interface ID of the function-specific control interface of the part.

HRESULT GetIID(
  GUID  *pIID
);

Parameters.

pIID

[out]  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
E_POINTER 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

Client: Windows Vista

Header: Include Devicetopology.h.

See Also

Previous Next