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
已啟用 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) |