SYNTH_PORTPARAMS 结构 (dmusprop.h)

项目
02/23/2024

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

“ 语音” 字段有效。

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 结构。

要求

要求	值
Header	dmusprop.h (包括 Dmusprop.h)

另请参阅

KSPROPERTY_SYNTH_PORTPARAMETERS

通过