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.