Compartilhar via


Função waveInGetDevCapsA (mmeapi.h)

A função waveInGetDevCapsA recupera os recursos de um determinado dispositivo de entrada waveform-audio. Esta é a versão ANSI dessa função.

Sintaxe

MMRESULT waveInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPWAVEINCAPSA pwic,
  UINT          cbwic
);

Parâmetros

uDeviceID

Identificador do dispositivo de entrada waveform-audio. Ele 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 WAVEINCAPSA a ser preenchida com informações sobre os recursos do dispositivo.

cbwic

Tamanho, em bytes, da estrutura WAVEINCAPSA .

Valor de retorno

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 Description
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.

Observações

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 a menos do 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 pela pwic. Se cbwic for zero, nada será copiado e a função retornará zero.

Requirements

Requirement Value
Cliente mínimo suportado Windows 2000 Professional
Servidor mínimo compatível Windows 2000 Server
Header mmeapi.h
Library Winmm.lib
de DLL Winmm.dll