IAudioTreble インターフェイス (devicetopology.h)
IAudioTreble インターフェイスを使用すると、ハードウェアトレブル レベルのコントロールにアクセスできます。 クライアントは、パラメーター refiid が REFIID IID_IAudioTrebleに設定された IPart::Activate メソッドを呼び出して、サブユニットの IAudioTreble インターフェイスへの参照を取得します。 IPart::Activate の呼び出しは、サブユニットが IAudioTreble インターフェイスをサポートしている場合にのみ成功します。 各チャネルのトレブル周波数のレベルを制御するためのハードウェア機能を表すサブユニット オブジェクトのみが、このインターフェイスをサポートします。
IAudioTreble インターフェイスは、オーディオ ストリーム内のトレブル周波数のゲインまたは減衰レベルを設定および取得するためのチャネルごとのコントロールを提供します。 トレブル レベルのハードウェア コントロールがオーディオ ストリーム内のチャネルのみを減衰できる場合、チャネルの最大トレブル レベルは 0 dB です。 トレブルレベルのコントロールがゲイン(増幅)を提供できる場合、最大トレブルレベルは0dBを超えます。
ほとんどの Windows オーディオ アダプター ドライバーは、Windows ドライバー モデル (WDM) をサポートし、カーネル ストリーミング (KS) プロパティを使用して、サブユニット (KS ノードと呼ばれます) のハードウェア制御パラメーターを表します。 IAudioTreble インターフェイスを使用すると、サブタイプ GUID 値が KSNODETYPE_TONE のサブユニットの KSPROPERTY_AUDIO_TREBLE プロパティに簡単にアクセスできます。 サブユニットのサブタイプ GUID を取得するには、 IPart::GetSubType メソッドを 呼び出します。 KS プロパティと KS ノードの種類の詳細については、Windows DDK のドキュメントを参照してください。
継承
IAudioTreble インターフェイスは、IPerChannelDbLevel インターフェイスから継承されます。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | devicetopology.h |