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構造体のメンバーを指定します。 このメンバーは、値が 0 であるか、次のフラグ ビットの 1 つ以上のビットごとの 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
ポートによって生成されるオーディオ データの 1 秒あたりのサンプル数を指定します。
EffectsFlags
このポートからのオーディオ出力に対して生成される効果の種類を指定します。 このメンバーは、値が 0 であるか、次のフラグ ビットの 1 つ以上のビットごとの 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 を含む) |