Share via

Función midiStreamProperty (mmeapi.h)

  • Artículo

La función midiStreamProperty establece o recupera propiedades de un flujo de datos MIDI asociado a un dispositivo de salida MIDI.

Sintaxis

MMRESULT midiStreamProperty(
  HMIDISTRM hms,
  LPBYTE    lppropdata,
  DWORD     dwProperty
);

Parámetros

hms

Controla el dispositivo MIDI al que está asociada la propiedad.

lppropdata

Puntero a los datos de propiedad.

dwProperty

Marcas que especifican la acción que se va a realizar e identificar la propiedad adecuada del flujo de datos MIDI. La función midiStreamProperty requiere establecer dos marcas en cada uso. Una marca (ya sea MIDIPROP_GET o MIDIPROP_SET) especifica una acción y la otra identifica una propiedad específica para examinar o editar.

Valor Significado
MIDIPROP_GET Recupera el valor actual de la propiedad especificada.
MIDIPROP_SET Establece la propiedad especificada.
MIDIPROP_TEMPO Recupera la propiedad tempo. El parámetro lppropdata apunta a una estructura MIDIPROPTEMPO . El valor de tempo actual se puede recuperar en cualquier momento. Los dispositivos de salida establecen el tempo insertando eventos MEVT_TEMPO en los datos MIDI.
MIDIPROP_TIMEDIV Especifica la propiedad de división de tiempo. Puede obtener o establecer esta propiedad. El parámetro lppropdata apunta a una estructura MIDIPROPTIMEDIV . Esta propiedad solo se puede establecer cuando se detiene el dispositivo.

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 especificado no es un identificador de flujo.
MMSYSERR_INVALPARAM
 El parámetro de identificador o marcas especificado no es válido.

Comentarios

Estas propiedades son las propiedades predeterminadas definidas por el sistema. Los escritores de controladores pueden implementar y documentar sus propias propiedades.

Requisitos

Requisito Value
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