IControlInterface：：GetIID 方法 (devicetopology.h)

GetIID 方法會取得元件之函式特定控制項介面的介面識別碼。

語法

HRESULT GetIID(
  [out] GUID *pIID
);

參數

[out] pIID

GUID 變數的指標，方法會寫入元件之函式特定控件介面的介面標識碼。 如需詳細資訊，請參閱＜備註＞。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼	Description
E_POINTER	指標 pIID 為 NULL。

備註

物件，表示連接器或子單位 (部分) 有兩個控制介面。 第一個是泛型控件介面 IControlInterface，其具有所有類型的控件通用的方法。 第二個是函式特定的控制項介面，其方法適用於特定類型的控制件。 GetIID 方法會取得第二個控件介面的介面標識碼。 用戶端可以將這個介面標識碼提供給 IPart：：Activate 方法，以建立元件函式特定介面的實例。

方法會取得下表所示的其中一個函式特定介面標識碼。

介面識別碼	介面名稱
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

 

若要取得介面的介面標識碼，請使用 __uuidof 運算符。 例如， IAudioAutoGainControl 介面的介面標識符定義如下：

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

如需__uuidof運算符的詳細資訊，請參閱 Windows SDK 檔。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	devicetopology.h

另請參閱

IControlInterface 介面