Compartilhar via


KSPROPERTY_AUDIO_CHANNEL_CONFIG

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ó.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY

KSAUDIO_CHANNEL_CONFIG

KSNODETYPE_DAC

KSNODETYPE_3D_EFFECTS

KSNODETYPE_VOLUME

KSNODETYPE_PROLOGIC_DECODER

KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

KSPROPERTY_AUDIO_VOLUMELEVEL