Compartir a través de


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