Estrutura WAVEOUTCAPSW (mmeapi.h)
A estrutura WAVEOUTCAPS descreve os recursos de um dispositivo de saída waveform-audio.
Sintaxe
typedef struct tagWAVEOUTCAPSW {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
WCHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPSW, *PWAVEOUTCAPSW, *NPWAVEOUTCAPSW, *LPWAVEOUTCAPSW;
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
| Requisito | Valor |
|---|---|
| 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) |