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结构成员包含有效数据。此成员是位域，其值为零或位或以下一个或多个标志位的按位 OR：

SYNTH_PORTPARAMS_VOICES

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

指定为此端口的音频输出生成的效果类型。此成员是位域，其值为零或位或以下一个或多个标志位的按位 OR：

SYNTH_EFFECT_REVERB

已启用混响。

SYNTH_EFFECT_CHORUS

启用合唱效果。

SYNTH_EFFECT_DELAY

已启用延迟效果。

如果未启用任何效果，此成员将设置为SYNTH_EFFECT_NONE，即零。

Share

指定端口的通道组是否共享。当此成员 TRUE时，所有端口都使用分配给此端口的通道组。当此成员 FALSE时，该端口以独占模式打开，不允许其他端口使用相同的通道组。

言论

KSPROPERTY_SYNTH_PORTPARAMETERS get-property 请求对其属性描述符和属性值使用SYNTH_PORTPARAMS结构。

要求

要求	价值
标头	dmusprop.h （包括 Dmusprop.h）

另请参阅

KSPROPERTY_SYNTH_PORTPARAMETERS

通过