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

IAudioMidrange インターフェイスを使用すると、ハードウェア ミッドレンジ レベルのコントロールにアクセスできます。 クライアントは、パラメーター refiid が REFIID IID_IAudioMidrangeに設定された IPart::Activate メソッドを呼び出すことによって、サブユニットの IAudioMidrange インターフェイスへの参照を取得します。 IPart::Activate の呼び出しは、サブユニットが IAudioMidrange インターフェイスをサポートしている場合にのみ成功します。 各チャネルのミッドレンジ周波数のレベルを制御するためのハードウェア機能を表すサブユニット オブジェクトのみが、このインターフェイスをサポートします。

IAudioMidrangeインターフェイスは、オーディオストリームのミッドレンジ周波数のゲインまたは減衰レベルを設定および取得するためのチャネルごとの制御を提供します。 ミッドレンジ レベルのハードウェア コントロールでオーディオ ストリーム内のチャネルのみを減衰できる場合、チャネルの最大ミッドレンジ レベルは 0 dB です。 ミッドレンジレベルのコントロールがゲイン(増幅)を提供できる場合、最大ミッドレンジレベルは0dBを超えます。

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

継承

IAudioMidrange インターフェイスは、IPerChannelDbLevel インターフェイスから継承されます。

要件

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

こちらもご覧ください

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

DeviceTopology API

IPart::Activate

IPerChannelDbLevel インターフェイス