Struttura WAVEFORMATEX (mmreg.h)

La struttura WAVEFORMATEX specifica il formato di dati di un flusso audio d'onda.

Sintassi

typedef struct tWAVEFORMATEX {
  WORD  wFormatTag;
  WORD  nChannels;
  DWORD nSamplesPerSec;
  DWORD nAvgBytesPerSec;
  WORD  nBlockAlign;
  WORD  wBitsPerSample;
  WORD  cbSize;
} WAVEFORMATEX, *PWAVEFORMATEX, *NPWAVEFORMATEX, *LPWAVEFORMATEX;

Members

wFormatTag

Specifica il tipo di formato audio waveform. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

nChannels

Specifica il numero di canali di dati audio. Per l'audio monofonico, impostare questo membro su 1. Per stereo, impostare questo membro su 2.

nSamplesPerSec

Specifica la frequenza di campionamento in cui deve essere riprodotto o registrato ogni canale. Se wFormatTag = WAVE_FORMAT_PCM, i valori comuni per nSamplesPerSec sono 8,0 kHz, 11,025 kHz, 22,05 kHz e 44,1 kHz. Ad esempio, per specificare una frequenza di campionamento di 11,025 kHz, impostare nSamplesPerSec su 11025. Per i formati non PCM, questo membro deve essere calcolato in base alla specifica del produttore del tag di formato.

nAvgBytesPerSec

Specifica la velocità di trasferimento dei dati media richiesta in byte al secondo. Questo valore è utile per stimare le dimensioni del buffer.

nBlockAlign

Specifica l'allineamento del blocco in byte. L'allineamento del blocco è la dimensione dell'unità atomica minima di dati per il tipo di formato wFormatTag . Se wFormatTag = WAVE_FORMAT_PCM o wFormatTag = WAVE_FORMAT_IEEE_FLOAT, impostare nBlockAlign su (nChannels*wBitsPerSample)/8, ovvero la dimensione di un singolo frame audio. Per i formati non PCM, questo membro deve essere calcolato in base alla specifica del produttore per il tag di formato.

La riproduzione e la registrazione del software devono elaborare un multiplo di byte nBlockAlign di dati alla volta. I dati scritti e letti da un dispositivo devono sempre iniziare all'inizio di un blocco.

wBitsPerSample

Specifica il numero di bit per campione per il tipo di formato specificato da wFormatTag. Se wFormatTag = WAVE_FORMAT_PCM, wBitsPerSample deve essere impostato su 8 o 16. Se wFormatTag = WAVE_FORMAT_IEEE_FLOAT, wBitsPerSample deve essere impostato su 32. Per i formati non PCM, impostare il valore di questo membro in base alla specifica del produttore per il tag di formato. Alcuni schemi di compressione non possono definire un valore per wBitsPerSample. In questo caso, impostare wBitsPerSample su zero.

cbSize

Specifica le dimensioni, in byte, delle informazioni di formato aggiuntive aggiunte alla fine della struttura WAVEFORMATEX. Queste informazioni possono essere usate dai formati non PCM per archiviare attributi aggiuntivi per wFormatTag. Se non sono richieste informazioni aggiuntive da wFormatTag, impostare questo membro su zero. Per i formati WAVE_FORMAT_PCM, i client devono ignorare questo membro (il relativo valore è implicitamente zero). Poiché tutti i client potrebbero non seguire questa regola, è consigliabile inizializzare cbSize su zero per i formati WAVE_FORMAT_PCM.

Commenti

La struttura WAVEFORMATEX può descrivere solo un subset dei formati che possono essere descritti dalla struttura WAVEFORMATEXTENSIBLE . Ad esempio, WAVEFORMATEX può descrivere flussi stereo a virgola mobile a virgola mobile (PCM) mono o (a due canali) con valori di esempio integer a 8 bit o a 16 bit o con valori di esempio a virgola mobile a 32 bit. Inoltre, WAVEFORMATEX può descrivere i formati non PCM più diffusi, ad esempio AC-3 e WMA Pro.

WAVEFORMATEX può descrivere in modo univoco i formati PCM mono o stereo per i quali il numero di bit validi per campione corrisponde alle dimensioni del contenitore di esempio. Per descrivere un formato PCM con più di due canali, è necessario WAVEFORMATEXTENSIBLE, che dispone di una maschera di canale per specificare la configurazione dell'altoparlante, ovvero il mapping dei canali alle posizioni del parlante fisico. Per descrivere un formato PCM per il quale il numero di bit validi per campione è minore delle dimensioni del contenitore di esempio (ad esempio, un campione a 20 bit archiviato in un contenitore a tre byte) richiede WAVEFORMATEXTENSIBLE, che specifica sia il numero di bit di esempio validi che le dimensioni del contenitore di esempio.

WAVEFORMATEX può descrivere i formati non PCM per i quali i tag di formato a 16 bit sono definiti nel file di intestazione Mmreg.h (ad esempio, WAVE_FORMAT_MPEG). Il membro wFormatTag di WAVEFORMATEX contiene il tag di formato. Specificare un formato non PCM per il quale un tag di formato non è definito in Mmreg.h da una struttura WAVEFORMATEXTENSIBLE, che contiene un GUID che identifica il formato. Se necessario, un fornitore di hardware può generare in modo indipendente un valore GUID per identificare un nuovo formato. La registrazione del GUID con Microsoft non è necessaria.

Per altre informazioni sulle differenze tra WAVEFORMATEX e WAVEFORMATEXTENSIBLE, vedere Descrittori extensible Wave-Format.

Il membro wFormatTag è impostato su uno dei tag di formato onda definiti in Mmreg.h. I tag per alcuni dei formati nonproprietari più comuni sono elencati nella tabella seguente.

Per l'elenco completo dei formati WAVE_FORMAT_Xxx , vedere Mmreg.h.

WAVEFORMATEX è quasi identico alla struttura PCMWAVEFORMAT, che è una struttura obsoleta usata per specificare i formati PCM. L'unica differenza è che WAVEFORMATEX contiene un membro cbSize e PCMWAVEFORMAT non lo fa. Per convenzione, cbSize deve essere ignorato quando wFormatTag = WAVE_FORMAT_PCM (perché cbSize è implicitamente zero). Questa convenzione consente al software driver di trattare le strutture WAVEFORMATEX e PCMWAVEFORMAT in modo identico nel caso di un formato PCM. Per altre informazioni su PCMWAVEFORMAT, vedere la documentazione di Microsoft Windows SDK.

Se wFormatTag = WAVE_FORMAT_PCM o wFormatTag = WAVE_FORMAT_IEEE_FLOAT, impostare cbSize su zero. Per tutti gli altri valori di wFormatTag, cbSize specifica il numero di byte di dati di formato aggiuntivi aggiunti alla struttura WAVEFORMATEX.

Se wFormatTag = WAVE_FORMAT_EXTENSIBLE, impostare cbSize su sizeof(WAVEFORMATEXTENSIBLE)-sizeof(WAVEFORMATEX) più le dimensioni di tutti i dati specifici del formato accodati alla struttura WAVEFORMATEXTENSIBLE.

Requisiti

Vedi anche

WAVEFORMATEXTENSIBLE