структура KSDATARANGE_MUSIC (ksmedia.h)

Статья
02/07/2025

Структура KSDATARANGE_MUSIC задает диапазон форматов DirectMusic MIDI.

Синтаксис

typedef struct {
  KSDATARANGE DataRange;
  GUID        Technology;
  ULONG       Channels;
  ULONG       Notes;
  ULONG       ChannelMask;
} KSDATARANGE_MUSIC, *PKSDATARANGE_MUSIC;

Члены

DataRange

Задает идентификаторы GUID основного формата и subFormat, а также GUID описателя для данных DirectMusic. Этот элемент является инициализированной структурой KSDATARANGE.

Technology

Указывает тип выходного устройства MIDI. Этот член может быть одним из следующих графических идентификаторов:

KSMUSIC_TECHNOLOGY_PORT

Устройство — это аппаратный порт MIDI.

KSMUSIC_TECHNOLOGY_SYNTH

Устройство является синтезатором.

KSMUSIC_TECHNOLOGY_SQSYNTH

Устройство является синтезатором квадратной волны.

KSMUSIC_TECHNOLOGY_FMSYNTH

Устройство является синтезатором FM.

KSMUSIC_TECHNOLOGY_MAPPER

Устройство — это приложение Microsoft MIDI mapper.

KSMUSIC_TECHNOLOGY_WAVETABLE

Устройство — это аппаратный синтезатор волны.

KSMUSIC_TECHNOLOGY_SWSYNTH

Устройство — это программный синтезатор.

Channels

Указывает максимальное количество одновременных каналов, которые могут воспроизводиться внутренним синтезатором устройства. Если устройство является портом, этот элемент не имеет значения и имеет значение нулю.

Notes

Указывает максимальное количество одновременных заметок, которое может воспроизводиться внутренним синтезатором. Если устройство является портом, этот элемент не имеет значения и имеет значение нулю.

ChannelMask

Указывает, на какие каналы отвечает внутреннее устройство синтезатора, где наименьший важный бит относится к каналу 0 и наиболее важному биту канала 15. Устройства портов, передаваемые во всех каналах, задают для этого элемента значение 0xFFFF.

Замечания

Примеры диапазонов данных, использующих структуру KSDATARANGE_MUSIC, см. в диапазоне данных MIDI Stream и диапазоне данных DirectMusic Stream.

Сведения о диапазонах данных и обработке пересечений см. в Data-Intersection обработчиках.

Требования

Требование	Ценность
заголовка	ksmedia.h (include Ksmedia.h)

См. также

KSDATARANGE

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