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)

另請參閱

KSPROPERTY_SYNTH_PORTPARAMETERS