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.

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.

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

See also

IControlInterface Interface