スピーカー構成の要求を変換

注 この情報は、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と見なします。