Share via

funzione midiInUnprepareHeader (mmeapi.h)

  • Articolo

La funzione midiInUnprepareHeader pulisce la preparazione eseguita dalla funzione midiInPrepareHeader .

Sintassi

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

Parametri

hmi

Gestire il dispositivo di input MIDI.

pmh

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

cbmh

Dimensioni 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
MIDIERR_STILLPLAYING
 Il buffer a cui punta lpMidiInHdr è ancora nella coda.
MMSYSERR_INVALPARAM
 Il puntatore o la struttura specificati non è valido.
MMSYSERR_INVALHANDLE
 L'handle del dispositivo specificato non è valido.

Commenti

Questa funzione è complementare a midiInPrepareHeader. È necessario usare questa funzione prima di liberare il buffer. Dopo aver passato un buffer al driver del dispositivo usando la funzione midiInAddBuffer , è necessario attendere fino al termine del buffer prima di usare midiInUnprepareHeader. Unpreparing di un buffer che non è stato preparato non ha alcun effetto e la funzione restituisce MMSYSERR_NOERROR.

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