Compartir a través de

Función midiStreamOut (mmeapi.h)

  • Artículo

La función midiStreamOut reproduce o pone en cola una secuencia (búfer) de datos MIDI en un dispositivo de salida MIDI.

Sintaxis

MMRESULT midiStreamOut(
  HMIDISTRM hms,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parámetros

hms

Identificador de una secuencia MIDI. Este identificador debe haber sido devuelto por una llamada a la función midiStreamOpen . Este identificador identifica el dispositivo de salida.

pmh

Puntero a una estructura MIDIHDR que identifica el búfer MIDI.

cbmh

Tamaño, en bytes, de la estructura MIDIHDR .

Valor devuelto

Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto Descripción
MMSYSERR_NOMEM
 El sistema no puede asignar o bloquear la memoria.
MIDIERR_STILLPLAYING
 El búfer de salida al que apunta lpMidiHdr sigue reproduciendo o se pone en cola desde una llamada anterior a midiStreamOut.
MIDIERR_UNPREPARED
 El encabezado al que apunta lpMidiHdr no se ha preparado.
MMSYSERR_INVALHANDLE
 El identificador de dispositivo especificado no es válido.
MMSYSERR_INVALPARAM
 El puntero especificado por lpMidiHdr no es válido.

Comentarios

Antes de pasar el búfer a midiStreamOpen, debe prepararse mediante la función midiOutPrepareHeader .

Dado que la función midiStreamOpen abre el dispositivo de salida en modo en pausa, debe llamar a la función midiStreamRestart antes de poder usar midiStreamOut para iniciar la reproducción.

Para la implementación actual de esta función, el búfer debe ser menor que 64K.

El búfer al que apunta la estructura MIDIHDR contiene uno o varios eventos MIDI, cada uno de los cuales se define mediante una estructura MIDIEVENT .

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 (incluya Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Funciones MIDI