структура SYNTH_PORTPARAMS (dmusprop.h)

Статья
02/06/2025

Структура SYNTH_PORTPARAMS содержит параметры конфигурации для порта DirectMusic , который является термином DirectMusic для устройства, отправляющего или получающего музыкальные данные. (В терминологии KS порт DirectMusic не соответствует драйверу порта DMus. Он соответствует закреплению отрисовки или записи в фильтре DirectMusic.)

Синтаксис

typedef struct _SYNTH_PORTPARAMS {
  DWORD ValidParams;
  DWORD Voices;
  DWORD ChannelGroups;
  DWORD AudioChannels;
  DWORD SampleRate;
  DWORD EffectsFlags;
  DWORD Share;
} SYNTH_PORTPARAMS, *PSYNTH_PORTPARAMS;

Члены

ValidParams

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

SYNTH_PORTPARAMS_VOICES

Поле голосов допустимо.

SYNTH_PORTPARAMS_CHANNELGROUPS

Допустимое поле ChannelGroups.

SYNTH_PORTPARAMS_AUDIOCHANNELS

Допустимое поле audioChannels.

SYNTH_PORTPARAMS_SAMPLERATE

Допустимое поле SampleRate.

SYNTH_PORTPARAMS_EFFECT

Допустимый флаг EffectsFlags.

SYNTH_PORTPARAMS_SHARE

Допустимое поле общего доступа.

Voices

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

ChannelGroups

Указывает количество групп каналов, запрошенных для этого порта. Каждая группа каналов содержит 16 каналов.

AudioChannels

Указывает количество аудиоканалов.

SampleRate

Указывает количество выборок в секунду для звуковых данных, созданных портом.

EffectsFlags

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

SYNTH_EFFECT_REVERB

Реверб включен.

SYNTH_EFFECT_CHORUS

Эффект хора включен.

SYNTH_EFFECT_DELAY

Эффект задержки включен.

Если эффекты не включены, этот элемент имеет значение SYNTH_EFFECT_NONE, что равно нулю.

Share

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

Замечания

KSPROPERTY_SYNTH_PORTPARAMETERS запрос get-property использует структуру SYNTH_PORTPARAMS как для дескриптора свойства, так и для значения свойства.

Требования

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

См. также

KSPROPERTY_SYNTH_PORTPARAMETERS

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