estrutura _WAVEFORMATEX

  • Artigo

A estrutura _WAVEFORMATEX define o formato de dados de áudio de forma de onda.

Sintaxe

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

Membros

Wformattag

Deve ser definido como um formato ou formatos compatíveis com o dispositivo. Observe que as versões anteriores do Windows Media Gerenciador de Dispositivos recomendadas usando WMDM_WAVE_FORMAT_ALL para indicar suporte para todos os formatos. No entanto, isso não é mais recomendado, pois diferentes players de mídia interpretarão isso de maneiras diferentes, e poucos dispositivos podem realmente reproduzir qualquer formato de arquivo. Agora é recomendável que você use o valor WMDM_ENUM_PROP_VALID_VALUES_ANY da enumeração WMDM_ENUM_PROP_VALID_VALUES_FORM ou especifique ainda um intervalo de formatos com a estrutura WMDM_PROP_VALUES_RANGE .

nChannels

Número de canais nos dados de áudio de forma de onda. Os dados monaural usam um canal e os dados estéreo usam dois canais.

nSamplesPerSec

Taxa de exemplo, em exemplos por segundo (Hertz), em que cada canal deve ser reproduzido ou gravado. Os valores comuns para nSamplesPerSec são 8,0 quilohertz (kHz), 11,025 kHz, 22,05 kHz e 44,1 kHz.

nAvgBytesPerSec

Taxa média de transferência de dados necessária para a marca de formato, em bytes por segundo. O software de reprodução e gravação pode estimar tamanhos de buffer usando o membro nAvgBytesPerSec .

nBlockAlign

Bloquear alinhamento, em bytes. O alinhamento do bloco é a unidade atômica mínima de dados para o tipo de formato wFormatTag . O software de reprodução e gravação deve processar vários bytes de dados nBlockAlign por vez. Os dados gravados e lidos de um dispositivo devem sempre começar no início de um bloco. Por exemplo, não é possível iniciar corretamente a reprodução de dados PCM no meio de um exemplo (ou seja, em um limite que não está alinhado a blocos).

wBitsPerSample

Bits por exemplo para o tipo de formato wFormatTag .

cbSize

Esse membro é ignorado.

Requisitos

Requisito Valor
parâmetro
Wmdm.idl

Confira também

IMDSPDevice::GetFormatSupport

IMDSPStorage::CreateStorage

IMDSPStorage::GetAttributes

IWMDMDevice::GetFormatSupport

IWMDMOperation::GetObjectAttributes

IWMDMOperation::SetObjectAttributes

IWMDMStorage::GetAttributes

Estruturas