IAudioChannelConfig インターフェイス (devicetopology.h)
IAudioChannelConfig インターフェイスは、ハードウェア チャネル構成コントロールへのアクセスを提供します。 クライアントは、パラメーター refiid が REFIID IID_IAudioChannelConfigに設定された IPart::Activate メソッドを呼び出して、サブユニットの IAudioChannelConfig インターフェイスへの参照を取得します。 IPart::Activate の呼び出しは、サブユニットが IAudioChannelConfig インターフェイスをサポートしている場合にのみ成功します。 このインターフェイスは、ハードウェア チャネル構成コントロールを表すサブユニット オブジェクトのみがサポートされます。
IAudioChannelConfig インターフェイスのクライアントは、チャネル構成マスクをコントロールに書き込むことで、ハードウェア チャネル構成コントロールをプログラムします。 マスクは、スピーカーへのオーディオ チャネルの割り当てを指定します。 チャネル構成マスクの詳細については、「 KSPROPERTY_AUDIO_CHANNEL_CONFIG」を参照してください。
ほとんどの Windows オーディオ アダプター ドライバーは、Windows ドライバー モデル (WDM) をサポートし、カーネル ストリーミング (KS) プロパティを使用して、サブユニット (KS ノードと呼ばれる) のハードウェア制御パラメーターを表します。 IAudioChannelConfig インターフェイスは、サブタイプ GUID 値が KSNODETYPE_3D_EFFECTS、KSNODETYPE_DAC、KSNODETYPE_VOLUME、または KSNODETYPE_PROLOGIC_DECODER であるサブユニットの KSPROPERTY_AUDIO_CHANNEL_CONFIG プロパティに簡単にアクセスできます。 サブユニットのサブタイプ GUID を取得するには、 IPart::GetSubType メソッドを呼び出します。 KS プロパティと KS ノードの種類の詳細については、Windows DDK のドキュメントを参照してください。
継承
IAudioChannelConfig インターフェイスは、IUnknown インターフェイスから継承されます。 IAudioChannelConfig には、次の種類のメンバーもあります。
メソッド
IAudioChannelConfig インターフェイスには、これらのメソッドがあります。
| IAudioChannelConfig::GetChannelConfig GetChannelConfig メソッドは、チャネル構成コントロールから現在のチャネル構成マスクを取得します。 |
| IAudioChannelConfig::SetChannelConfig SetChannelConfig メソッドは、チャネル構成コントロールでチャネル構成マスクを設定します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | devicetopology.h |