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 |
|---|---|
|
O identificador de dispositivo especificado é inválido. |
|
O endereço especificado é inválido. |
|
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 |