Compartir a través de

Función midiOutUnprepareHeader (mmeapi.h)

  • Artículo

La función midiOutUnprepareHeader limpia la preparación realizada por la función midiOutPrepareHeader .

Sintaxis

MMRESULT midiOutUnprepareHeader(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parámetros

hmo

Controla el dispositivo de salida MIDI. Este parámetro también puede ser el identificador de una transmisión MIDI que se convierte en HMIDIOUT.

pmh

Puntero a una estructura MIDIHDR que identifica el búfer que se va a limpiar.

cbmh

Tamaño, en bytes, 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 lpMidiOutHdr todavía está en la cola.
MMSYSERR_INVALHANDLE
 El identificador de dispositivo especificado no es válido.
MMSYSERR_INVALPARAM
 El puntero o la estructura especificados no son válidos.

Comentarios

Esta función es complementaria a la función midiOutPrepareHeader . Debe llamar a midiOutUnprepareHeader antes de liberar el búfer. Después de pasar un búfer al controlador del dispositivo con la función midiOutLongMsg , debe esperar hasta que finalice el controlador del dispositivo con el búfer antes de llamar a midiOutUnprepareHeader.

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