Función midiStreamOpen (mmeapi.h)

Artículo
08/24/2023

La función midiStreamOpen abre una secuencia MIDI para la salida. De forma predeterminada, el dispositivo se abre en modo en pausa. El identificador de secuencia recuperado por esta función debe usarse en todas las referencias posteriores a la secuencia.

Sintaxis

MMRESULT midiStreamOpen(
  LPHMIDISTRM phms,
  LPUINT      puDeviceID,
  DWORD       cMidi,
  DWORD_PTR   dwCallback,
  DWORD_PTR   dwInstance,
  DWORD       fdwOpen
);

Parámetros

phms

Puntero a una variable que va a contener el identificador de secuencia cuando la función devuelve.

puDeviceID

Puntero a un identificador de dispositivo. El dispositivo se abre en nombre de la secuencia y se cierra de nuevo cuando se cierra la secuencia.

cMidi

Reservados; debe ser 1.

dwCallback

Puntero a una función de devolución de llamada, un controlador de eventos, un identificador de subproceso o un identificador de una ventana o subproceso llamado durante la reproducción MIDI para procesar mensajes relacionados con el progreso de la reproducción. Si no se desea ningún mecanismo de devolución de llamada, especifique NULL para este parámetro.

dwInstance

Datos de instancia específicos de la aplicación que se devuelven a la aplicación con cada función de devolución de llamada.

fdwOpen

Marca de devolución de llamada para abrir el dispositivo. Se debe especificar una de las marcas de devolución de llamada siguientes.

Valor	Significado
CALLBACK_EVENT	El parámetro dwCallback es un identificador de eventos. Este mecanismo de devolución de llamada es solo para la salida.
CALLBACK_FUNCTION	El parámetro dwCallback es una dirección de procedimiento de devolución de llamada. Para obtener la firma de devolución de llamada, consulte MidiOutProc.
CALLBACK_NULL	No hay ningún mecanismo de devolución de llamada. Esta es la configuración predeterminada.
CALLBACK_THREAD	El parámetro dwCallback es un identificador de subproceso.
CALLBACK_WINDOW	El parámetro dwCallback es un identificador de ventana.

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_BADDEVICEID	El identificador de dispositivo especificado está fuera del intervalo.
MMSYSERR_INVALPARAM	El parámetro de identificador o marcas especificado no es válido.
MMSYSERR_NOMEM	El sistema no puede asignar o bloquear la memoria.

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