estructura KSAUDIO_CHANNEL_CONFIG (ksmedia.h)

La estructura KSAUDIO_CHANNEL_CONFIG especifica la configuración de canales dentro del formato de datos de una secuencia de audio.

Sintaxis

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

Miembros

ActiveSpeakerPositions

Especifica tanto el número de canales como la asignación de esos canales a las posiciones del hablante. Este miembro es una máscara de bits en la que cada bit dentro de la máscara corresponde a una posición de altavoz determinada. Si se establece un bit de máscara, la secuencia de audio contiene un canal asignado a la posición del altavoz que representa el bit de máscara. El número de canales de la secuencia se obtiene contando cuántos números aparecen en la máscara de bits. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Comentarios

Esta estructura se usa para establecer u obtener el valor de datos de la propiedad KSPROPERTY_AUDIO_CHANNEL_CONFIG .

En la tabla siguiente se muestran los bits de marca definidos para el miembro ActiveSpeakerPositions .

Cada formato de datos de audio contiene canales para una o varias de las posiciones anteriores del hablante. El número de canales simplemente es igual al número de bits de marca distinto de cero en el miembro ActiveSpeakerPositions .

Las posiciones relativas de los canales dentro de cada bloque de datos de audio siempre siguen el mismo orden relativo que los bits de marca de la tabla anterior. Por ejemplo, si ActiveSpeakerPositions contiene el valor 0x00000033, el formato define cuatro canales de audio asignados para la reproducción en los altavoces front-left, front-right, back-left y back-right, respectivamente. Los datos del canal se deben intercalar en ese orden dentro de cada bloque. (Esta es la configuración de KSAUDIO_SPEAKER_QUAD que aparece en la segunda de las dos tablas siguientes).

En la tabla siguiente se muestran las configuraciones del altavoz definidas para DVD.

En la tabla siguiente se muestran las configuraciones de altavoz definidas para DirectSound.

La configuración del altavoz KSAUDIO_SPEAKER_7POINT1 está obsoleta y ya no se admite.

En la tabla anterior, la constante KSAUDIO_SPEAKER_DIRECTOUT tiene un valor de cero, lo que significa que no se asigna ninguna posición del hablante a los canales de la secuencia multicanal. Por ejemplo, el canal cero podría representar percusión, el canal 1 podría representar trompeta, el canal 2 podría representar la voz, etc. En esta configuración, los canales del flujo de entrada se generan directamente en el hardware sin modificaciones y sin interpretarse como posiciones del hablante. Para obtener más información, consulte DSSPEAKER_DIRECTOUT Speaker Configuration.

La configuración del altavoz para un formato envolvente de canal 5.1 se define mediante la constante KSAUDIO_SPEAKER_5POINT1_SURROUND de la tabla anterior. El diseño geométrico de los altavoces se muestra en la ilustración siguiente, que muestra las posiciones de los altavoces frontal izquierda, frontal derecha, frontal, lateral izquierda y derecha. La figura omite el altavoz de baja frecuencia porque no es direccionable.

En este ejemplo, en la lista siguiente se muestra el orden de los seis canales dentro de cada bloque de datos de audio:

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 un formato PCM con un tamaño de muestra de 16 bits, cada bloque de datos de audio ocupa 12 bytes, que se ordenan como se muestra en la tabla siguiente.

Requisitos

Consulte también

KSPROPERTY_AUDIO_CHANNEL_CONFIG

WAVEFORMATEXTENSIBLE