Compartilhar via


Função midiInAddBuffer (mmeapi.h)

A função midiInAddBuffer envia um buffer de entrada para um dispositivo de entrada MIDI aberto especificado. Essa função é usada para mensagens exclusivas do sistema.

Sintaxe

MMRESULT midiInAddBuffer(
  HMIDIIN   hmi,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parâmetros

hmi

Identificador para o dispositivo de entrada MIDI.

pmh

Ponteiro para uma estrutura MIDIHDR que identifica o buffer.

cbmh

Tamanho, em bytes, da estrutura MIDIHDR .

Valor retornado

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
MIDIERR_STILLPLAYING
O buffer apontado por lpMidiInHdr ainda está na fila.
MIDIERR_UNPREPARED
O buffer apontado por lpMidiInHdr não foi preparado.
MMSYSERR_INVALHANDLE
O identificador de dispositivo especificado é inválido.
MMSYSERR_INVALPARAM
O ponteiro ou estrutura especificado é inválido.
MMSYSERR_NOMEM
O sistema não pode alocar ou bloquear memória.

Comentários

Quando o buffer é preenchido, ele é enviado de volta para o aplicativo.

O buffer deve ser preparado usando a função midiInPrepareHeader antes de ser passado para a função midiInAddBuffer .

Requisitos

   
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

Funções MIDI