Compartilhar via


Função waveInAddBuffer (mmeapi.h)

A função waveInAddBuffer envia um buffer de entrada para o dispositivo de entrada waveform-audio fornecido. Quando o buffer é preenchido, o aplicativo é notificado.

Sintaxe

MMRESULT waveInAddBuffer(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parâmetros

hwi

Identificador para o dispositivo de entrada waveform-audio.

pwh

Ponteiro para uma estrutura WAVEHDR que identifica o buffer.

cbwh

Tamanho, em bytes, da estrutura WAVEHDR .

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.
WAVERR_UNPREPARED
O buffer apontado pelo parâmetro pwh não foi preparado.

Comentários

Quando o buffer é preenchido, o WHDR_DONE bit é definido no membro dwFlags da estrutura WAVEHDR .

O buffer deve ser preparado com a função waveInPrepareHeader antes de ser passado para essa 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]
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