Função waveInStart (mmeapi.h)

A função waveInStart inicia a entrada no dispositivo de entrada waveform-audio especificado.

Sintaxe

MMRESULT waveInStart(
  HWAVEIN hwi
);

Parâmetros

hwi

Identificador para o dispositivo de entrada waveform-audio.

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_INVALHANDLE	O identificador de dispositivo especificado é inválido.
MMSYSERR_NODRIVER	Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM	Não é possível alocar ou bloquear memória.

Comentários

Os buffers são retornados ao aplicativo quando cheios ou quando a função waveInReset é chamada (o membro dwBytesRecorded no cabeçalho conterá o comprimento dos dados). Se não houver buffers na fila, os dados serão descartados sem notificar o aplicativo e a entrada continuará.

Chamar essa função quando a entrada já está iniciada não tem efeito e a função retorna 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