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.

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

Confira também

Alocando e preparando blocos de dados MIDI

Funções MIDI

midiInUnprepareHeader