SYNTH_PORTPARAMS 構造体 (dmusprop.h)

[アーティクル]
08/07/2023

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 を含む)

こちらもご覧ください

KSPROPERTY_SYNTH_PORTPARAMETERS

次の方法で共有