estrutura KSAUDIO_CHANNEL_CONFIG (ksmedia.h)

A estrutura KSAUDIO_CHANNEL_CONFIG especifica a configuração de canais no formato de dados de um fluxo de áudio.

Sintaxe

typedef struct {
  LONG ActiveSpeakerPositions;
} KSAUDIO_CHANNEL_CONFIG, *PKSAUDIO_CHANNEL_CONFIG;

Membros

ActiveSpeakerPositions

Especifica o número de canais e a atribuição desses canais para posições de locutor. Esse membro é uma máscara de bits na qual cada bit dentro da máscara corresponde a uma posição de alto-falante específica. Se um bit de máscara for definido, o fluxo de áudio conterá um canal atribuído à posição do alto-falante que o bit de máscara representa. O número de canais no fluxo é obtido contando quantos números aparecem na máscara de bits. Para obter mais informações, consulte a seção Comentários a seguir.

Comentários

Essa estrutura é usada para definir ou obter o valor de dados para a propriedade KSPROPERTY_AUDIO_CHANNEL_CONFIG .

A tabela a seguir mostra os bits de sinalizador definidos para o membro ActiveSpeakerPositions .

Cada formato de dados de áudio contém canais para uma ou mais das posições anteriores do locutor. O número de canais simplesmente é igual ao número de bits de sinalizador diferente de zero no membro ActiveSpeakerPositions .

As posições relativas dos canais dentro de cada bloco de dados de áudio sempre seguem a mesma ordenação relativa que os bits de sinalizador na tabela anterior. Por exemplo, se ActiveSpeakerPositions contiver o valor 0x00000033, o formato definirá quatro canais de áudio atribuídos para reprodução aos alto-falantes front-left, front-right, back-left e back-right, respectivamente. Os dados do canal devem ser intercalados nessa ordem dentro de cada bloco. (Essa é a configuração KSAUDIO_SPEAKER_QUAD que aparece no segundo das duas tabelas a seguir.)

A tabela a seguir mostra as configurações do locutor definidas para DVD.

A tabela a seguir mostra as configurações do locutor definidas para DirectSound.

A configuração do alto-falante KSAUDIO_SPEAKER_7POINT1 está obsoleta e não tem mais suporte.

Na tabela anterior, a constante KSAUDIO_SPEAKER_DIRECTOUT tem um valor zero, o que significa que nenhuma posição de locutor é atribuída aos canais no fluxo multicanal. Por exemplo, o canal zero pode representar percussão, o canal 1 pode representar trompete, o canal 2 pode representar voz e assim por diante. Nessa configuração, os canais no fluxo de entrada são gerados diretamente para o hardware sem modificação e sem serem interpretados como posições de alto-falante. Para obter mais informações, consulte DSSPEAKER_DIRECTOUT Configuração do Locutor.

A configuração do alto-falante para um formato surround de 5,1 canais é definida pela constante KSAUDIO_SPEAKER_5POINT1_SURROUND na tabela anterior. O layout geométrico dos alto-falantes é mostrado na figura a seguir, que mostra as posições dos alto-falantes front-left, front-right, front-center, side-left e side-right. A figura omite o alto-falante de baixa frequência porque ele não é direcional.

Para este exemplo, a lista a seguir mostra a ordenação dos seis canais dentro de cada bloco de dados de áudio:

1. SPEAKER_FRONT_LEFT

2. SPEAKER_FRONT_RIGHT

3. SPEAKER_FRONT_CENTER

4. SPEAKER_LOW_FREQUENCY

5. SPEAKER_SIDE_LEFT

6. SPEAKER_SIDE_RIGHT

Para um formato PCM com um tamanho de exemplo de 16 bits, cada bloco de dados de áudio ocupa 12 bytes, que são ordenados conforme mostrado na tabela a seguir.

Requisitos

Confira também

KSPROPERTY_AUDIO_CHANNEL_CONFIG

WAVEFORMATEXTENSIBLE