SYNTH_PORTPARAMS結構 (dmusprop.h)
SYNTH_PORTPARAMS 結構包含 DirectMusic 埠的組態參數，這是傳送或接收音樂數據之裝置的 DirectMusic 詞彙。 (在 KS 術語中，DirectMusic 埠不會對應至 DMus 埠驅動程式。它會對應至 DirectMusic filter 上的轉譯或擷取釘選。)
語法
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
已啟用 Chorus 效果。
SYNTH_EFFECT_DELAY
已啟用延遲效果。
如果未啟用任何效果，這個成員會設定為 SYNTH_EFFECT_NONE，也就是零。
Share
指定是否共用埠的通道群組。 當此成員為 TRUE時，所有埠都會使用指派給此埠的通道群組。 當這個成員為 FALSE 時，埠會以獨佔模式開啟，而且不允許其他埠使用相同的通道群組。
備註
KSPROPERTY_SYNTH_PORTPARAMETERS get-property 要求會針對其屬性描述元及其屬性值使用SYNTH_PORTPARAMS結構。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | dmusprop.h (包含 Dmusprop.h) |