スピーカー構成の要求を変換
注 この情報は、Windows XP 以前のオペレーティング システムに適用されます。 Windows Vista 以降では、IDirectSound::GetSpeakerConfig と IDirectSound::SetSpeakerConfig は非推奨になりました。
アプリケーションがIDirectSound::SetSpeakerConfig (Microsoft Windows SDK のドキュメントを参照) を呼び出してスピーカー構成を変更すると、DirectSound は指定された DSSPEAKER_Xxxスピーカー設定パラメーターを同等の KSAUDIO_Xxxチャネル構成マスクに変換します。 このマスクを含むKSPROPERTY_AUDIO_CHANNEL_CONFIGプロパティの設定要求を DirectSound デバイスを表すフィルターに送信します。
次の表では、左側の各DSSPEAKER_Xxxパラメータが、右側の同等のKSAUDIO_Xxxチャネル設定マスクとペアになっています。
| DSSPEAKER パラメータ | KSAUDIO チャネル構成マスク |
|---|---|
DSSPEAKER_DIRECTOUT |
KSAUDIO_SPEAKER_DIRECTOUT |
DSSPEAKER_HEADPHONE |
KSAUDIO_SPEAKER_STEREO |
DSSPEAKER_MONO |
KSAUDIO_SPEAKER_MONO |
DSSPEAKER_STEREO |
KSAUDIO_SPEAKER_STEREO |
DSSPEAKER_QUAD |
KSAUDIO_SPEAKER_QUAD |
DSSPEAKER_SURROUND |
KSAUDIO_SPEAKER_SURROUND |
DSSPEAKER_5POINT1 |
KSAUDIO_SPEAKER_5POINT1 |
DSSPEAKER_7POINT1 |
KSAUDIO_SPEAKER_7POINT1 |
前の表では、DirectSound は、同じチャネル マスク KSAUDIO_SPEAKER_STEREO を使用して、ヘッドフォンとステレオの両方のスピーカー構成を指定しています。 これら 2 つの構成を区別するために、DirectSound は、スピーカー ジオメトリを指定する 2 番目のプロパティ設定要求をフィルターに送信します (KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRYを参照)。 ヘッドフォンを示すために、DirectSound は speaker-geometry 要求で値 KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONE を渡します。
ただし、ステレオ スピーカーの場合、 SetSpeakerConfig の呼び出し元は、いくつかの可能なDSSPEAKER_Xxxステレオ スピーカー ジオメトリの 1 つを指定できます。 これらは次の表の左側の列に表示され、同等の KSAUDIO_Xxxパラメーターが右側に表示されます。
| DSSPEAKERステレオスピーカージオメトリ | KSAUDIO ステレオ スピーカーのジオメトリ |
|---|---|
DSSPEAKER_GEOMETRY_WIDE |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE |
DSSPEAKER_GEOMETRY_NARROW |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW |
DSSPEAKER_GEOMETRY_MIN |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN |
DSSPEAKER_GEOMETRY_MAX |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX |
呼び出し元が上の左の列のジオメトリの 1 つを明示的に指定していない場合、DirectSound は既定でDSSPEAKER_GEOMETRY_WIDEと見なします。