Función midiInStart (mmeapi.h)

  • Artículo

La función midiInStart inicia la entrada MIDI en el dispositivo de entrada MIDI especificado.

Sintaxis

MMRESULT midiInStart(
  HMIDIIN hmi
);

Parámetros

hmi

Controla el dispositivo de entrada MIDI.

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

Esta función restablece la marca de tiempo en cero; los valores de marca de tiempo para los mensajes recibidos posteriormente son relativos al momento en que se llamó a esta función.

Todos los mensajes excepto los exclusivos del sistema se envían directamente al cliente cuando se reciben. Los mensajes exclusivos del sistema se colocan en los búferes proporcionados por la función midiInAddBuffer . Si no hay búferes en la cola, los datos exclusivos del sistema se descartan sin notificación al cliente y continúa la entrada. Los búferes se devuelven al cliente cuando están llenos, cuando se recibe un mensaje completo exclusivo del sistema o cuando se usa la función midiInReset . El miembro dwBytesRecorded de la estructura MIDIHDR contendrá la longitud real de los datos recibidos.

Llamar a esta función cuando la entrada ya está iniciada no tiene ningún efecto y la función devuelve cero.

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