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
MIDIERR_STILLPLAYING	El búfer al que apunta lpMidiInHdr todavía está en la cola.
MMSYSERR_INVALPARAM	El puntero o la estructura especificados no son válidos.
MMSYSERR_INVALHANDLE	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

Consulte también

Asignar y preparar bloques de datos MIDI

Funciones MIDI