Edit

IControlInterface::GetIID method (devicetopology.h)

  • Article

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
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

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

See also

IControlInterface Interface