Função waveInGetDevCaps (mmeapi.h)

  • Artigo

A função waveInGetDevCaps recupera os recursos de um determinado dispositivo de entrada waveform-audio.

Sintaxe

MMRESULT waveInGetDevCaps(
  UINT         uDeviceID,
  LPWAVEINCAPS pwic,
  UINT         cbwic
);

Parâmetros

uDeviceID

Identificador do dispositivo de saída waveform-audio. Pode ser um identificador de dispositivo ou um identificador de um dispositivo de entrada de áudio de forma de onda aberta.

pwic

Ponteiro para uma estrutura WAVEINCAPS a ser preenchida com informações sobre os recursos do dispositivo.

cbwic

Tamanho, em bytes, da estrutura WAVEINCAPS .

Retornar valor

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMSYSERR_BADDEVICEID
 O identificador de dispositivo especificado está fora do intervalo.
MMSYSERR_NODRIVER
 Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM
 Não é possível alocar ou bloquear memória.

Comentários

Use essa função para determinar o número de dispositivos de entrada waveform-audio presentes no sistema. Se o valor especificado pelo parâmetro uDeviceID for um identificador de dispositivo, ele poderá variar de zero a um menor que o número de dispositivos presentes. A constante WAVE_MAPPER também pode ser usada como um identificador de dispositivo. Somente bytes cbwic (ou menos) de informações são copiados para o local apontado por pwic. Se cbwic for zero, nada será copiado e a função retornará zero.

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]
Plataforma de Destino Windows
Cabeçalho mmeapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Áudio de forma de onda

Funções waveform