PKEY_AudioEndpoint_FullRangeSpeakers

A propriedade PKEY_AudioEndpoint_FullRangeSpeakers especifica a máscara de configuração de canal para os alto-falantes de intervalo completo conectados ao dispositivo de ponto de extremidade de áudio. A máscara indica a configuração física dos alto-falantes de intervalo completo e especifica a atribuição de canais a esses alto-falantes.

O membro vt da estrutura PROPVARIANT é definido como VT_UI4.

O membro uintVal da estrutura PROPVARIANT contém uma máscara de configuração de canal que é convertida para o tipo UINT.

Um alto-falante de gama completa é capaz de tocar sons ao longo de toda a gama de baixo a agudos. Normalmente, alto-falantes maiores são de alcance total, mas alto-falantes menores são significativamente menos capazes de tocar sons de baixo. No Windows Vista, o mecanismo de áudio usa essa propriedade para gerenciar níveis baixos no fluxo de saída de áudio que é reproduzido pelo dispositivo de ponto de extremidade de áudio.

A máscara de configuração de canal para essa propriedade está no mesmo formato que a máscara de configuração de canal para a propriedade PKEY_AudioEndpoint_PhysicalSpeakers . Para obter mais informações sobre máscaras de configuração de canal, consulte KSPROPERTY_AUDIO_CHANNEL_CONFIG.

O sistema obtém a máscara de configuração de canal para a propriedade PKEY_AudioEndpoint_FullRangeSpeakers do usuário. O usuário insere essas informações por meio do painel de controle multimídia do Windows, Mmsys.cpl. Para obter mais informações sobre Mmsys.cpl, consulte a documentação do DDK do Windows.

A máscara de configuração de canal para a propriedade PKEY_AudioEndpoint_FullRangeSpeakers de um dispositivo de ponto de extremidade de áudio é um subconjunto da máscara de configuração de canal para a propriedade PKEY_AudioEndpoint_PhysicalSpeakers do mesmo dispositivo.

Por exemplo, se um dispositivo de ponto de extremidade de áudio conduz um conjunto de alto-falantes de som surround 5.1, a máscara de configuração de canal para a propriedade PKEY_AudioEndpoint_PhysicalSpeakers é KSAUDIO_SPEAKER_5POINT1. Essa máscara indica a presença de alto-falantes front-left, front-right, front-center, side-left e side-right, além de um subwoofer. Se os alto-falantes front-left e front-right forem grandes o suficiente para produzir sons baixos, mas os alto-falantes frontais e laterais menores não forem, a máscara de configuração de canal para a propriedade PKEY_AudioEndpoint_FullRangeSpeakers será KSAUDIO_SPEAKER_STEREO, o que indica apenas os alto-falantes frontal-esquerdo e frontal-direito. Máscaras de configuração de canal KSAUDIO_SPEAKER_5POINT1 e KSAUDIO_SPEAKER_STEREO são definidas no arquivo de cabeçalho Ksmedia.h.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
parâmetro
Mmdeviceapi.h

Confira também

Propriedades do ponto de extremidade de áudio

Principais propriedades de áudio

Propriedade PKEY_AudioEndpoint_PhysicalSpeakers