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 |