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 |
|---|---|
|
L'handle del dispositivo specificato non è valido. |
|
L'indirizzo specificato non è valido. |
|
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 |