KSAUDIO_CHANNEL_CONFIG struttura (ksmedia.h)

La struttura KSAUDIO_CHANNEL_CONFIG specifica la configurazione dei canali nel formato dati di un flusso audio.

Sintassi

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

Members

ActiveSpeakerPositions

Specifica sia il numero di canali che l'assegnazione di tali canali alle posizioni dell'altoparlante. Questo membro è una maschera di bit in cui ogni bit all'interno della maschera corrisponde a una determinata posizione dell'altoparlante. Se viene impostato un bit di maschera, il flusso audio contiene un canale assegnato alla posizione dell'altoparlante che rappresenta il bit maschera. Il numero di canali nel flusso viene ottenuto conteggiando il numero di numeri visualizzati nella maschera di bit. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

Questa struttura viene usata per impostare o ottenere il valore dei dati per la proprietà KSPROPERTY_AUDIO_CHANNEL_CONFIG .

La tabella seguente mostra i bit di flag definiti per il membro ActiveSpeakerPositions .

Ogni formato di dati audio contiene canali per una o più posizioni dell'altoparlante precedente. Il numero di canali equivale semplicemente al numero di bit di flag non zero nel membro ActiveSpeakerPositions .

Le posizioni relative dei canali all'interno di ogni blocco di dati audio seguono sempre lo stesso ordinamento relativo dei bit del flag nella tabella precedente. Ad esempio, se ActiveSpeakerPositions contiene il valore 0x00000033, il formato definisce rispettivamente quattro canali audio assegnati per la riproduzione a sinistra, front-destra, back-left e back-right. I dati del canale devono essere interleaved in tale ordine all'interno di ogni blocco. Si tratta della configurazione KSAUDIO_SPEAKER_QUAD visualizzata nella seconda delle due tabelle seguenti.

Nella tabella seguente vengono illustrate le configurazioni dell'altoparlante definite per DVD.

Nella tabella seguente vengono illustrate le configurazioni dell'altoparlante definite per DirectSound.

La configurazione dell'altoparlante KSAUDIO_SPEAKER_7POINT1 è obsoleta e non è più supportata.

Nella tabella precedente, la costante KSAUDIO_SPEAKER_DIRECTOUT ha un valore pari a zero, il che significa che nessuna posizione dell'altoparlante viene assegnata ai canali nel flusso multicanale. Ad esempio, il canale zero potrebbe rappresentare le percussioni, il canale 1 potrebbe rappresentare tromba, canale 2 potrebbe rappresentare la voce e così via. In questa configurazione, i canali nel flusso di input vengono restituiti direttamente all'hardware senza modifiche e senza essere interpretati come posizioni altoparlanti. Per altre informazioni, vedere DSSPEAKER_DIRECTOUT Configurazione altoparlanti.

La configurazione dell'altoparlante per un formato surround a 5.1 canali è definita dalla costante KSAUDIO_SPEAKER_5POINT1_SURROUND nella tabella precedente. Il layout geometrico degli altoparlanti è illustrato nella figura seguente, che mostra le posizioni delle altoparlanti front-left, front-right, front-center, lato sinistro e laterale destro. La figura omette l'altoparlante a bassa frequenza perché non è bidirezionale.

Per questo esempio, l'elenco seguente mostra l'ordinamento dei sei canali all'interno di ogni blocco di dati 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

Per un formato PCM con dimensioni di esempio a 16 bit, ogni blocco di dati audio occupa 12 byte, ordinati come illustrato nella tabella seguente.

Requisiti

Vedi anche

KSPROPERTY_AUDIO_CHANNEL_CONFIG

WAVEFORMATEXTENSIBLE