Función midiInUnprepareHeader (mmeapi.h)
La función midiInUnprepareHeader limpia la preparación realizada por la función midiInPrepareHeader .
Sintaxis
MMRESULT midiInUnprepareHeader(
HMIDIIN hmi,
LPMIDIHDR pmh,
UINT cbmh
);
Parámetros
hmi
Identificador del dispositivo de entrada MIDI.
pmh
Puntero a una estructura MIDIHDR que identifica el búfer que se va a limpiar.
cbmh
Tamaño de la estructura MIDIHDR .
Valor devuelto
Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.
Código devuelto | Descripción |
---|---|
|
El búfer al que apunta lpMidiInHdr todavía está en la cola. |
|
El puntero o la estructura especificados no son válidos. |
|
El identificador de dispositivo especificado no es válido. |
Comentarios
Esta función es complementaria a midiInPrepareHeader. Debe usar esta función antes de liberar el búfer. Después de pasar un búfer al controlador del dispositivo mediante la función midiInAddBuffer , debe esperar hasta que el controlador finalice con el búfer antes de usar midiInUnprepareHeader. La anulación de la preparación de un búfer que no se ha preparado no tiene ningún efecto y la función devuelve MMSYSERR_NOERROR.
Requisitos
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | mmeapi.h (incluya Windows.h) |
Library | Winmm.lib |
Archivo DLL | Winmm.dll |