Función midiStreamOpen (mmeapi.h)
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 |
---|---|
|
El identificador de dispositivo especificado está fuera del intervalo. |
|
El parámetro de identificador o marcas especificado no es válido. |
|
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 |