Поделиться через

Функция midiStreamProperty (mmeapi.h)

  • Статья

Функция midiStreamProperty задает или извлекает свойства потока данных MIDI, связанного с устройством вывода MIDI.

Синтаксис

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

Параметры

hms

Дескриптор MIDI-устройства, с которым связано свойство.

lppropdata

Указатель на данные свойства.

dwProperty

Флаги, указывающие выполняемое действие и определяющее соответствующее свойство потока данных MIDI. Функция midiStreamProperty требует установки двух флагов при каждом использовании. Один флаг (MIDIPROP_GET или MIDIPROP_SET) указывает действие, а другой определяет определенное свойство для проверки или изменения.

Значение Значение
MIDIPROP_GET Извлекает текущее значение заданного свойства.
MIDIPROP_SET Задает заданное свойство.
MIDIPROP_TEMPO Извлекает свойство tempo. Параметр lppropdata указывает на структуру MIDIPROPTEMPO . Текущее значение темпа можно получить в любое время. Устройства вывода задают темп, вставляя события MEVT_TEMPO в данные MIDI.
MIDIPROP_TIMEDIV Задает свойство деления времени. Это свойство можно получить или задать. Параметр lppropdata указывает на структуру MIDIPROPTIMEDIV . Это свойство можно задать, только если устройство остановлено.

Возвращаемое значение

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата Описание
MMSYSERR_INVALHANDLE
 Указанный дескриптор не является дескриптором потока.
MMSYSERR_INVALPARAM
 Данный параметр handle или flags недопустим.

Комментарии

Эти свойства являются свойствами по умолчанию, определенными системой. Средства записи драйверов могут реализовывать и документировать собственные свойства.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmeapi.h (включая Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll

См. также раздел

Функции MIDI