Función midiOutShortMsg (mmeapi.h)

La función midiOutShortMsg envía un mensaje MIDI corto al dispositivo de salida MIDI especificado.

Sintaxis

MMRESULT midiOutShortMsg(
  HMIDIOUT hmo,
  DWORD    dwMsg
);

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.

dwMsg

Mensaje MIDI. El mensaje se empaqueta en un valor DWORD con el primer byte del mensaje en el byte de orden bajo. El mensaje se empaqueta en este parámetro de la siguiente manera.

Word	Byte	Uso
Alto	Orden superior	No se usa.
	Orden bajo	Segundo byte de datos MIDI (cuando sea necesario).
Bajo	Orden superior	Primer byte de datos MIDI (cuando sea necesario).
	Orden bajo	Estado MIDI.

 

Los dos bytes de datos MIDI son opcionales, según el byte de estado MIDI. Cuando una serie de mensajes tienen el mismo byte de estado, el byte de estado se puede omitir de los mensajes después del primero de la serie, creando un estado en ejecución. Empaquete un mensaje para ejecutar el estado de la siguiente manera:

Word	Byte	Uso
Alto	Orden superior	No se usa.
	Orden bajo	No se usa.
Bajo	Orden superior	Segundo byte de datos MIDI (cuando sea necesario).
	Orden bajo	Primer byte de datos MIDI.

Valor devuelto

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

Código devuelto	Descripción
MIDIERR_BADOPENMODE	La aplicación envió un mensaje sin un byte de estado a un identificador de secuencia.
MIDIERR_NOTREADY	El hardware está ocupado con otros datos.
MMSYSERR_INVALHANDLE	El identificador de dispositivo especificado no es válido.

Comentarios

Esta función se usa para enviar cualquier mensaje MIDI excepto para los mensajes exclusivos del sistema o de transmisión.

Esta función podría no devolverse hasta que se haya enviado el mensaje al dispositivo de salida. Puede enviar mensajes cortos mientras se reproducen secuencias en el mismo dispositivo (aunque no puede usar un estado en ejecución en este caso).

Requisitos

Requisito	Value
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