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

Статья
08/07/2023

Структура 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, порт открывается в монопольном режиме и использование одних и те же групп каналов другими портами не допускается.

Требования

Требование	Значение
Заголовок	dmusprop.h (включая Dmusprop.h)

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

KSPROPERTY_SYNTH_PORTPARAMETERS