IControlInterface::GetIID メソッド (devicetopology.h)

GetIID メソッドは、パーツの関数固有の制御インターフェイスのインターフェイス ID を取得します。

構文

HRESULT GetIID(
  [out] GUID *pIID
);

パラメーター

[out] pIID

メソッドがパーツの関数固有のコントロール インターフェイスのインターフェイス ID を書き込む GUID 変数へのポインター。 詳細については、「解説」を参照してください。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード	説明
E_POINTER	ポインター pIID は NULL です。

注釈

パーツ (コネクタまたはサブユニット) を表す オブジェクトには、2 つのコントロール インターフェイスがあります。 1 つ目は、すべての種類のコントロールに共通するメソッドを持つ汎用コントロール インターフェイス IControlInterface です。 2 つ目は、特定の種類のコントロールに適用されるメソッドを持つ関数固有のコントロール インターフェイスです。 GetIID メソッドは、2 番目のコントロール インターフェイスのインターフェイス ID を取得します。 クライアントは、このインターフェイス ID を IPart::Activate メソッドに指定して、パーツの関数固有のインターフェイスのインスタンスを作成できます。

メソッドは、次の表に示す関数固有のインターフェイス ID のいずれかを取得します。

インターフェイス ID	インターフェイス名
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

 

インターフェイスのインターフェイス ID を取得するには、 __uuidof 演算子を使用します。 たとえば、 IAudioAutoGainControl インターフェイスのインターフェイス ID は次のように定義されます。

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

__uuidof 演算子の詳細については、Windows SDKのドキュメントを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	devicetopology.h

こちらもご覧ください

IControlInterface インターフェイス