IAudioAutoGainControl インターフェイス (devicetopology.h)

  • [アーティクル]

IAudioAutoGainControl インターフェイスは、ハードウェアの自動ゲイン制御 (AGC) へのアクセスを提供します。 クライアントは、パラメーター refiid が REFIID IID_IAudioAutoGainControlに設定された IPart::Activate メソッドを呼び出して、サブユニットの IAudioAutoGainControl インターフェイスへの参照を取得します。 IPart::Activate の呼び出しは、サブユニットが IAudioAutoGainControl インターフェイスをサポートしている場合にのみ成功します。 ハードウェア AGC 関数を表すサブユニット オブジェクトのみが、このインターフェイスをサポートします。

ほとんどの Windows オーディオ アダプター ドライバーは、Windows ドライバー モデル (WDM) をサポートし、カーネル ストリーミング (KS) プロパティを使用して、サブユニット (KS ノードと呼ばれる) のハードウェア制御パラメーターを表します。 IAudioAutoGainControl インターフェイスは、サブタイプ GUID 値が KSNODETYPE_AGC であるサブユニットの KSPROPERTY_AUDIO_AGC プロパティに簡単にアクセスできます。 サブユニットのサブタイプ GUID を取得するには、 IPart::GetSubType メソッドを呼び出します。 KS プロパティと KS ノードの種類の詳細については、Windows DDK のドキュメントを参照してください。

継承

IAudioAutoGainControl インターフェイスは、IUnknown インターフェイスから継承されます。 IAudioAutoGainControl には、次の種類のメンバーもあります。

メソッド

IAudioAutoGainControl インターフェイスには、これらのメソッドがあります。

 
IAudioAutoGainControl::GetEnabled

GetEnabled メソッドは、AGC の現在の状態 (有効または無効) を取得します。
IAudioAutoGainControl::SetEnabled

SetEnabled メソッドは AGC を有効または無効にします。

要件

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

こちらもご覧ください

コア オーディオ インターフェイス

DeviceTopology API

IPart::Activate