共用方式為


SYNTH_PORTPARAMS結構 (dmusprop.h)

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)

另請參閱

KSPROPERTY_SYNTH_PORTPARAMETERS