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.