funzione midiInPrepareHeader (mmeapi.h)

La funzione midiInPrepareHeader prepara un buffer per l'input MIDI.

Sintassi

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

Parametri

hmi

Gestire il dispositivo di input MIDI. Per ottenere l'handle del dispositivo, chiamare midiInOpen.

pmh

Puntatore a una struttura MIDIHDR che identifica il buffer da preparare.

Prima di chiamare la funzione, impostare i membri lpData, dwBufferLength e dwFlags della struttura MIDIHDR . Il membro dwFlags deve essere impostato su zero.

cbmh

Dimensioni, in byte, della struttura MIDIHDR .

Valore restituito

Restituisce MMSYSERR_NOERROR se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
MMSYSERR_INVALHANDLE	L'handle del dispositivo specificato non è valido.
MMSYSERR_INVALPARAM	L'indirizzo specificato non è valido.
MMSYSERR_NOMEM	Il sistema non è in grado di allocare o bloccare la memoria.

Commenti

Prima di passare un blocco di dati MIDI a un driver di dispositivo, è necessario preparare il buffer passandolo alla funzione midiInPrepareHeader . Dopo aver preparato l'intestazione, non modificare il buffer. Dopo aver eseguito il driver usando il buffer, chiamare la funzione midiInUnprepareHeader .

L'applicazione può riutilizzare lo stesso buffer o allocare più buffer e chiamare midiInPrepareHeader per ogni buffer. Se si usa nuovamente lo stesso buffer, non è necessario preparare il buffer ogni volta. È possibile chiamare midiInPrepareHeader una volta all'inizio e quindi chiamare midiInUnprepareHeader una volta alla fine.

La preparazione di un'intestazione già preparata non ha alcun effetto e la funzione restituisce zero.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mmeapi.h (includere Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Allocazione e preparazione di blocchi di dati MIDI

Funzioni MIDI

midiInUnprepareHeader