Übersetzen Speaker-Configuration Anforderungen
Hinweis Diese Informationen gelten für Windows XP und frühere Betriebssysteme. Ab Windows Vista sind IDirectSound::GetSpeakerConfig und IDirectSound::SetSpeakerConfig veraltet.
Wenn eine Anwendung IDirectSound::SetSpeakerConfig aufruft (siehe Microsoft Windows SDK-Dokumentation), um die Lautsprecherkonfiguration zu ändern, übersetzt DirectSound den angegebenen DSSPEAKER_Xxx-Lautsprecherkonfigurationsparameter in die entsprechende KSAUDIO_Xxx-Kanalkonfigurationsmaske. Es sendet eine KSPROPERTY_AUDIO_CHANNEL_CONFIG Set-Eigenschaftsanforderung, die diese Maske enthält, an den Filter, der das DirectSound-Gerät darstellt.
In der folgenden Tabelle wird jeder DSSPEAKER_Xxx-Parameter auf der linken Seite mit der entsprechenden KSAUDIO_Xxx-Kanalkonfigurationsmaske auf der rechten Seite gekoppelt.
DSSPEAKER-Parameter | KSAUDIO Channel-Configuration Maske |
---|---|
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 |
In der obigen Tabelle gibt DirectSound sowohl die Kopfhörer- als auch die Stereolautsprecherkonfigurationen mit derselben Kanalmaske an, KSAUDIO_SPEAKER_STEREO. Um zwischen diesen beiden Konfigurationen zu unterscheiden, sendet DirectSound dem Filter eine zweite Set-Eigenschaftsanforderung, die eine Lautsprechergeometrie angibt (siehe KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY). Um Kopfhörer anzugeben, übergibt DirectSound den Wert KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONE mit der Anforderung lautsprechergeometrie.
Bei Stereolautsprechern kann der Aufrufer von SetSpeakerConfig jedoch eine von mehreren möglichen DSSPEAKER_Xxx Stereolautsprechergeometrien angeben. Diese werden in der linken Spalte der folgenden Tabelle angezeigt, und die entsprechenden KSAUDIO_Xxx-Parameter werden auf der rechten Seite angezeigt.
DSSPEAKER Stereo-Speaker Geometry | KSAUDIO Stereo-Speaker Geometry |
---|---|
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 |
Wenn der Aufrufer eine der Geometrien in der linken Spalte oben nicht explizit angibt, geht DirectSound standardmäßig von DSSPEAKER_GEOMETRY_WIDE aus.