Partager via


Traduction de requêtes Speaker-Configuration

Note Ces informations s’appliquent à Windows XP et aux systèmes d’exploitation antérieurs. À compter de Windows Vista, IDirectSound::GetSpeakerConfig et IDirectSound::SetSpeakerConfig ont été déconseillés.

Lorsqu’une application appelle IDirectSound::SetSpeakerConfig (voir Microsoft Windows SDK documentation) pour modifier la configuration de l’orateur, DirectSound traduit le paramètre de configuration de l’orateur DSSPEAKER_Xxx spécifié en masque de configuration de canal KSAUDIO_Xxx équivalent. Il envoie une KSPROPERTY_AUDIO_CHANNEL_CONFIG demande set-property contenant ce masque au filtre qui représente l’appareil DirectSound.

Dans le tableau suivant, chaque paramètre DSSPEAKER_Xxx à gauche est associé au masque de configuration de canal KSAUDIO_Xxx équivalent à droite.

Paramètre DSSPEAKER Masque de Channel-Configuration 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

Dans le tableau précédent, DirectSound spécifie à la fois ses configurations casque et haut-parleur stéréo avec le même masque de canal, KSAUDIO_SPEAKER_STEREO. Pour distinguer ces deux configurations, DirectSound envoie au filtre une deuxième requête set-property, qui spécifie une géométrie d’orateur (voir KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY). Pour indiquer un casque, DirectSound transmet la valeur KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONE avec la requête speaker-geometry.

Toutefois, dans le cas des haut-parleurs stéréo, l’appelant de SetSpeakerConfig peut spécifier l’une des géométries d’enceintes stéréo DSSPEAKER_Xxx possibles. Ceux-ci apparaissent dans la colonne de gauche du tableau suivant, et les paramètres KSAUDIO_Xxx équivalents s’affichent à droite.

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

Si l’appelant ne spécifie pas explicitement l’une des géométries dans la colonne de gauche ci-dessus, DirectSound suppose DSSPEAKER_GEOMETRY_WIDE par défaut.