Traduzindo solicitações de Speaker-Configuration
Nota Essas informações se aplicam ao Windows XP e a sistemas operacionais anteriores. A partir do Windows Vista, IDirectSound::GetSpeakerConfig e IDirectSound::SetSpeakerConfig foram preteridos.
Quando um aplicativo chama IDirectSound::SetSpeakerConfig (consulte SDK do Microsoft Windows documentação) para alterar a configuração do alto-falante, o DirectSound converte o parâmetro de configuração do alto-falante DSSPEAKER_Xxx especificado para a máscara de configuração de canal KSAUDIO_Xxx equivalente. Ele envia uma KSPROPERTY_AUDIO_CHANNEL_CONFIG solicitação set-property que contém essa máscara para o filtro que representa o dispositivo DirectSound.
Na tabela a seguir, cada parâmetro DSSPEAKER_Xxx à esquerda é emparelhado com a máscara de configuração de canal KSAUDIO_Xxx equivalente à direita.
| Parâmetro DSSPEAKER | Máscara 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 |
Na tabela anterior, o DirectSound especifica suas configurações de fone de ouvido e alto-falante estéreo com a mesma máscara de canal, KSAUDIO_SPEAKER_STEREO. Para distinguir entre essas duas configurações, o DirectSound envia ao filtro uma segunda solicitação set-property, que especifica uma geometria do alto-falante (consulte KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY). Para indicar fones de ouvido, o DirectSound passa o valor KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONE com a solicitação de geometria do alto-falante.
No caso de alto-falantes estéreo, no entanto, o chamador para SetSpeakerConfig pode especificar uma das várias geometrias possíveis do alto-falante estéreo DSSPEAKER_Xxx . Eles aparecem na coluna esquerda da tabela a seguir e os parâmetros equivalentes KSAUDIO_Xxx aparecem à direita.
| Geometria Stereo-Speaker DSSPEAKER | Geometria de Stereo-Speaker 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 |
Se o chamador não especificar explicitamente uma das geometrias na coluna esquerda acima, DirectSound pressupõe DSSPEAKER_GEOMETRY_WIDE por padrão.