次の方法で共有


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

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

構文

HRESULT GetIID(
  [out] GUID *pIID
);

パラメーター

[out] pIID

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

戻り値

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

リターン コード 説明
E_POINTER
ポインター pIIDNULL です

注釈

パーツ (コネクタまたはサブユニット) を表す オブジェクトには、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 インターフェイス