KSPROPERTY_AUDIO_CHANNEL_CONFIG

Artigo
06/14/2023

A propriedade KSPROPERTY_AUDIO_CHANNEL_CONFIG especifica o posicionamento espacial real dos canais no fluxo de áudio gerado por um nó.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Sim	Filtrar/Fixar	KSNODEPROPERTY	KSAUDIO_CHANNEL_CONFIG

O valor da propriedade (dados de operação) é uma estrutura do tipo KSAUDIO_CHANNEL_CONFIG. Essa estrutura especifica os canais contidos no fluxo de saída e a atribuição desses canais aos alto-falantes.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_CHANNEL_CONFIG retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Comentários

Quando usada como uma propriedade de um nó da DAC (KSNODETYPE_DAC) ou nó 3D (KSNODETYPE_3D_EFFECTS), a propriedade KSPROPERTY_AUDIO_CHANNEL_CONFIG especifica a configuração do alto-falante DirectSound. Para configurações de alto-falante estéreo, essa propriedade é usada em conjunto com a propriedade KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY , que distingue entre fones de ouvido e várias configurações de alto-falante estéreo. Para obter mais informações sobre as configurações do locutor, consulte Configurações de Speaker-Configuration directSound.

O DirectSound também usa a propriedade KSPROPERTY_AUDIO_CHANNEL_CONFIG para consultar um nó "pan" para sua configuração de canal. Um nó de painel é o segundo nó de volume (KSNODETYPE_VOLUME) em um pino de mixer que atende aos requisitos de ordenação de nó do DirectSound. A implementação directSound do método IDirectSoundBuffer::SetPan (descrito na documentação do SDK do Microsoft Windows) usa a propriedade KSPROPERTY_AUDIO_VOLUMELEVEL do nó do painel para controlar o movimento panorâmico.

O DirectSound trata KSPROPERTY_AUDIO_CHANNEL_CONFIG como uma propriedade de filtro em um nó DAC e como uma propriedade de pino em nós 3D e volume.

Os clientes também usam essa propriedade para selecionar o formato do fluxo que um KSNODETYPE_PROLOGIC_DECODER saídas de nó.