Función midiConnect (mmeapi.h)

  • Artículo

La función midiConnect conecta un dispositivo de entrada MIDI a un dispositivo midi thru o output, o conecta un dispositivo midi thru a un dispositivo de salida MIDI.

Sintaxis

MMRESULT midiConnect(
  HMIDI    hmi,
  HMIDIOUT hmo,
  LPVOID   pReserved
);

Parámetros

hmi

Asa a un dispositivo de entrada MIDI o a un dispositivo midi thru. (Para los dispositivos thru, este identificador debe haber sido devuelto por una llamada a la función midiOutOpen ).

hmo

Controle la salida MIDI o el dispositivo thru.

pReserved

Reservados; debe ser NULL.

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
MIDIERR_NOTREADY
 El dispositivo de entrada especificado ya está conectado a un dispositivo de salida.
MMSYSERR_INVALHANDLE
 El identificador de dispositivo especificado no es válido.

Comentarios

Después de llamar a esta función, el dispositivo de entrada MIDI recibe datos de eventos en un mensaje de MIM_DATA cada vez que se envía un mensaje con los mismos datos de evento al controlador del dispositivo de salida.

Un controlador thru es una forma especial del controlador de salida MIDI. El sistema solo permitirá que un dispositivo de salida MIDI esté conectado a un dispositivo de entrada MIDI, pero varios dispositivos de salida MIDI se pueden conectar a un dispositivo midi thru. Cada vez que el dispositivo de entrada MIDI especificado recibe datos de eventos en un mensaje de MIM_DATA, se envía un mensaje con los mismos datos de evento al controlador de dispositivo de salida especificado (o a través del controlador thru a los controladores de salida).

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