WAVEFORMATEX (Waveform Audio)

9/8/2008

Essa estrutura define o formato da forma de onda-áudio dados. Formato comum informações somente a forma de onda todos-áudio formatos dados está incluído nessa estrutura. Para formatos que exigem informações adicionais, essa estrutura é incluída como o primeiro membro em outra estrutura, along with as informações adicionais.

Syntax

typedef struct {
  WORD wFormatTag; 
  WORD nChannels; 
  DWORD nSamplesPerSec; 
  DWORD nAvgBytesPerSec; 
  WORD nBlockAlign; 
  WORD wBitsPerSample; 
  WORD cbSize;} 
WAVEFORMATEX; 

Os membros

• wFormatTag
  Forma de onda-tipo formato de áudio. Formato marcas são registradas com Microsoft Corporation para Muitos algoritmos compactação. Um lista completa de formato marcas podem ser encontradas no arquivo de cabeçalho Mmreg.h.

• nChannels
  Número de canais na forma de onda-áudio dados. Dados estéreo monaural dados usa canalizar um e dois canais.

• nSamplesPerSec
  Taxa de exemplo, em amostras por segundo (Hertz), que cada canalizar deve ser executado ou gravado. Se wFormatTag é WAVE_FORMAT_PCM, e em seguida, comum valores para nSamplesPerSec São possível 8.0, possível 11.025, 22.05 possível e 44,1 possível. Para formatos não-PCM, esse membro deve ser calculado de acordo com especificação do fabricante da marca de formato.

• nAvgBytesPerSec
  Necessário médio dados-transferir taxa, em bytes por segundo, para a marca formato. Se wFormatTag é WAVE_FORMAT_PCM, nAvgBytesPerSec Deve ser igual ao produto do nSamplesPerSec e nBlockAlign. Para formatos não-PCM, esse membro deve ser calculado de acordo com especificação do fabricante da marca de formato.

  Software de reprodução e registro pode estimar reserva tamanhos usando o nAvgBytesPerSec membro.

• nBlockAlign
  Bloquear alinhamento, em bytes. O alinhamento bloco é a unidade atômica mínima de dados para o wFormatTag tipo formato. Se wFormatTag é WAVE_FORMAT_PCM, nBlockAlign Deve ser igual ao produto do nChannels e wBitsPerSample dividida por 8 (bits por byte). Para formatos não-PCM, esse membro deve ser calculado de acordo com especificação do fabricante da marca de formato.

  Software de reprodução e registro deve processo um múltiplo de nBlockAlign bytes de dados em um tempo. Dados gravados e ler de um dispositivo devem sempre iniciar no início de um bloco. Por exemplo, é ilegal para iniciar reprodução de dados de PCM in the middle of um exemplo (isto é, em um limite non-Block-aligned).

• wBitsPerSample
  Bits por exemplo para o wFormatTag tipo formato. Se wFormatTag For WAVE_FORMAT_PCM, então wBitsPerSample Deve ser igual a 8 ou 16. Para formatos não-PCM, esse membro deve ser definido de acordo com especificação do fabricante da marca de formato. Alguns esquemas compactação não é possível definir um valor para wBitsPerSample, portanto, esse membro pode ser zero.

• cbSize
  Tamanho, em bytes, do adicional informações formato acrescentadas ao final das WAVEFORMATEX estrutura. Este informações podem ser usadas por não-PCM formatos para armazenar adicional atributos para o wFormatTag. Se nenhum adicional informações é exigido pela wFormatTag, esse membro deve ser definido como zero. Para apenas formatos WAVE_FORMAT_PCM, esse membro será ignorado.

Remarks

Um exemplo de um formato que usa adicional informações é o formato Microsoft Adaptive Delta Pulse Code Modulation (MS-ADPCM). O wFormatTag MS-ADPCM é WAVE_FORMAT_ADPCM. O cbSize membro é geralmente definida como 32. O adicional informações armazenadas para WAVE_FORMAT_ADPCM é pares coeficiente exigido para codificação e decodificação a forma de onda-áudio dados.

Requirements

Header	mmsystem.h
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Waveform Audio Structures