Share via

Estrutura WAVEOUTCAPSA (mmeapi.h)

  • Artigo

A estrutura WAVEOUTCAPS descreve os recursos de um dispositivo de saída waveform-audio.

Sintaxe

typedef struct tagWAVEOUTCAPSA {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  CHAR      szPname[MAXPNAMELEN];
  DWORD     dwFormats;
  WORD      wChannels;
  WORD      wReserved1;
  DWORD     dwSupport;
} WAVEOUTCAPSA, *PWAVEOUTCAPSA, *NPWAVEOUTCAPSA, *LPWAVEOUTCAPSA;

Membros

wMid

Identificador do fabricante do driver de dispositivo para o dispositivo. Os identificadores do fabricante são definidos em Identificadores de Fabricante e Produto.

wPid

Identificador de produto para o dispositivo. Identificadores de produto são definidos em Fabricante e Identificadores de Produto.

vDriverVersion

Número de versão do driver de dispositivo para o dispositivo. O byte de alta ordem é o número de versão principal e o byte de baixa ordem é o número de versão secundária.

szPname[MAXPNAMELEN]

Nome do produto em uma cadeia de caracteres terminada em nulo.

dwFormats

Formatos padrão com suporte. Pode ser uma combinação do seguinte:

Formatar Descrição
WAVE_FORMAT_1M08 11,025 kHz, mono, 8 bits
WAVE_FORMAT_1M16 11,025 kHz, mono, 16 bits
WAVE_FORMAT_1S08 11,025 kHz, estéreo, 8 bits
WAVE_FORMAT_1S16 11,025 kHz, estéreo, 16 bits
WAVE_FORMAT_2M08 22,05 kHz, mono, 8 bits
WAVE_FORMAT_2M16 22,05 kHz, mono, 16 bits
WAVE_FORMAT_2S08 22,05 kHz, estéreo, 8 bits
WAVE_FORMAT_2S16 22,05 kHz, estéreo, 16 bits
WAVE_FORMAT_4M08 44,1 kHz, mono, 8 bits
WAVE_FORMAT_4M16 44,1 kHz, mono, 16 bits
WAVE_FORMAT_4S08 44,1 kHz, estéreo, 8 bits
WAVE_FORMAT_4S16 44,1 kHz, estéreo, 16 bits
WAVE_FORMAT_96M08 96 kHz, mono, 8 bits
WAVE_FORMAT_96M16 96 kHz, mono, 16 bits
WAVE_FORMAT_96S08 96 kHz, estéreo, 8 bits
WAVE_FORMAT_96S16 96 kHz, estéreo, 16 bits

wChannels

Número que especifica se o dispositivo dá suporte à saída mono (1) ou estéreo (2).

wReserved1

dwSupport

Funcionalidade opcional compatível com o dispositivo. Os seguintes valores são definidos:

Sinalizador Descrição
WAVECAPS_LRVOLUME Dá suporte ao controle de volume à esquerda e à direita separados.
WAVECAPS_PITCH Dá suporte ao controle de tom.
WAVECAPS_PLAYBACKRATE Dá suporte ao controle de taxa de reprodução.
WAVECAPS_SYNC O driver é síncrono e será bloqueado durante a reprodução de um buffer.
WAVECAPS_VOLUME Dá suporte ao controle de volume.
WAVECAPS_SAMPLEACCURATE Retorna informações de posição precisas de exemplo.

Comentários

Se um dispositivo der suporte a alterações de volume, o sinalizador WAVECAPS_VOLUME será definido para o membro dwSupport . Se um dispositivo der suporte a alterações de volume separadas nos canais esquerdo e direito, os sinalizadores WAVECAPS_VOLUME e WAVECAPS_LRVOLUME serão definidos para esse membro.

Observação

O cabeçalho mmeapi.h define WAVEOUTCAPS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho mmeapi.h (inclua Windows.h)

Confira também

Áudio de forma de onda

Estruturas de forma de onda