Función midiOutReset (mmeapi.h)

La función midiOutReset desactiva todas las notas de todos los canales MIDI para el dispositivo de salida MIDI especificado.

Sintaxis

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

Parámetros

hmo

Controla el dispositivo de salida MIDI. Este parámetro también puede ser el controlador de un flujo MIDI convertido a HMIDIOUT.

Valor devuelto

Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto Descripción
MMSYSERR_INVALHANDLE
El identificador de dispositivo especificado no es válido.

Comentarios

Los búferes de salida de flujo o exclusivos del sistema pendientes se devuelven a la función de devolución de llamada y la marca MHDR_DONE se establece en el miembro dwFlags de la estructura MIDIHDR .

La terminación de un mensaje exclusivo del sistema sin enviar un byte EOX (fin de exclusivo) puede causar problemas para el dispositivo receptor. La función midiOutReset no envía un byte EOX cuando finaliza un mensaje exclusivo del sistema: las aplicaciones son responsables de hacerlo.

Para desactivar todas las notas, se envía un mensaje de nota desactivado para cada nota de cada canal. Además, el controlador de mantenimiento está desactivado para cada canal.

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 (incluye Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Funciones MIDI