Compartilhar via


Função midiInPrepareHeader (mmeapi.h)

A função midiInPrepareHeader prepara um buffer para entrada MIDI.

Sintaxe

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

Parâmetros

hmi

Identificador para o dispositivo de entrada MIDI. Para obter o identificador do dispositivo, chame midiInOpen.

pmh

Ponteiro para uma estrutura MIDIHDR que identifica o buffer a ser preparado.

Antes de chamar a função, defina os membros lpData, dwBufferLength e dwFlags da estrutura MIDIHDR . O membro dwFlags deve ser definido como zero.

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
MMSYSERR_INVALHANDLE
O identificador de dispositivo especificado é inválido.
MMSYSERR_INVALPARAM
O endereço especificado é inválido.
MMSYSERR_NOMEM
O sistema não pode alocar ou bloquear memória.

Comentários

Antes de passar um bloco de dados MIDI para um driver de dispositivo, você deve preparar o buffer passando-o para a função midiInPrepareHeader . Depois que o cabeçalho for preparado, não modifique o buffer. Depois que o driver terminar de usar o buffer, chame a função midiInUnprepareHeader .

O aplicativo pode reutilizar o mesmo buffer ou alocar vários buffers e chamar midiInPrepareHeader para cada buffer. Se você reutilize o mesmo buffer, não será necessário preparar o buffer a cada vez. Você pode chamar midiInPrepareHeader uma vez no início e, em seguida, chamar midiInUnprepareHeader uma vez no final.

Preparar um cabeçalho que já foi preparado não tem efeito e a função retorna zero.

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

Alocando e preparando blocos de dados MIDI

Funções MIDI

midiInUnprepareHeader