Speaker-Configuration-aanvragen vertalen

Opmerking Deze informatie is van toepassing op Windows XP en eerdere besturingssystemen. Vanaf Windows Vista zijn IDirectSound::GetSpeakerConfig en IDirectSound::SetSpeakerConfig afgeschaft.

Wanneer een toepassing IDirectSound::SetSpeakerConfig (zie microsoft Windows SDK-documentatie) aanroept om de configuratie van de luidspreker te wijzigen, vertaalt DirectSound de opgegeven parameter DSSPEAKER_Xxx speaker-configuratie in het equivalente KSAUDIO_Xxx kanaalconfiguratiemasker. Er wordt een KSPROPERTY_AUDIO_CHANNEL_CONFIG set-property-aanvraag met dit masker verzonden naar het filter dat het DirectSound-apparaat vertegenwoordigt.

In de volgende tabel wordt elke parameter DSSPEAKER_Xxx aan de linkerkant gekoppeld aan het equivalente KSAUDIO_Xxx kanaalconfiguratiemasker aan de rechterkant.

DSSPEAKER-parameter	KSAUDIO Channel-Configuration masker
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 (surround-geluidssysteem)
DSSPEAKER_5POINT1	KSAUDIO_SPEAKER_5POINT1
DSSPEAKER_7POINT1	KSAUDIO_SPEAKER_7POINT1

In de voorgaande tabel geeft DirectSound zowel de hoofdtelefoon- als stereoluidsprekerconfiguraties aan met hetzelfde kanaalmasker, KSAUDIO_SPEAKER_STEREO. Als u onderscheid wilt maken tussen deze twee configuraties, verzendt DirectSound het filter een tweede aanvraag voor een seteigenschap, waarmee een geometrie van de spreker wordt opgegeven (zie KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY). Om een hoofdtelefoon aan te geven, geeft DirectSound de waarde KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONE door met de aanvraag voor sprekergeometrie.

In het geval van stereoluidsprekers kan de beller echter SetSpeakerConfig een van de mogelijke DSSPEAKER_Xxx stereo-luidsprekergeometrieën opgeven. Deze worden weergegeven in de linkerkolom van de volgende tabel en de equivalente KSAUDIO_Xxx parameters worden rechts weergegeven.

DSSPEAKER Stereo-Speaker Geometrie	KSAUDIO Stereo-Speaker Geometrie
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

Als de aanroeper niet expliciet een van de geometrieën in de bovenstaande linkerkolom opgeeft, wordt in DirectSound standaard uitgegaan van DSSPEAKER_GEOMETRY_WIDE.