KSDSOUND_BUFFERDESC構造体 (ksmedia.h)

[アーティクル]
02/07/2025

KSDSOUND_BUFFERDESC構造体は、DirectSound バッファーを記述します。

構文

typedef struct {
  ULONG        Flags;
  ULONG        Control;
  WAVEFORMATEX WaveFormatEx;
} KSDSOUND_BUFFERDESC, *PKSDSOUND_BUFFERDESC;

メンバーズ

Flags

バッファー構成を指定します。このメンバーは、次のフラグビットの 1 つ以上のビットごとの OR に設定できます。

KSDSOUND_BUFFER_PRIMARY

バッファーがプライマリサウンドバッファー (ゲームのプレイ時にユーザーが読み上げるバッファー) であることを示します。

KSDSOUND_BUFFER_STATIC

バッファーが静的サウンドデータに使用されることを示します。

KSDSOUND_BUFFER_LOCHARDWARE

バッファーにハードウェアミキシングを強制的に使用します。

KSDSOUND_BUFFER_LOCSOFTWARE

バッファーを強制的にシステムメモリに格納し、ソフトウェアミキシングを使用します。

Control

バッファーの機能を指定します。バッファーの機能は、一連の制御フラグによって表されます。このメンバーは、次のフラグビットの 1 つ以上のビットごとの OR に設定できます。

KSDSOUND_BUFFER_CTRL_3D

バッファーが 3D 制御機能を持つプライマリバッファーまたはセカンダリバッファーであることを示します。このビットが設定されている場合、バッファーを表す KS ピンは 3D ノード (KSNODETYPE_3D_EFFECTS) を実装します。 KSDSOUND_BUFFER_CTRL_HRTF_3D ビットが設定されている場合、3D ノードはオプションの KSPROPSETID_Hrtf3d プロパティセットをサポートします。

KSDSOUND_BUFFER_CTRL_FREQUENCY

バッファーに周波数制御機能があることを示します。このビットが設定されている場合、バッファーを表すピンはサンプルレート変換 (KSNODETYPE_SRC) ノードを実装します。

KSDSOUND_BUFFER_CTRL_HRTF_3D

バッファーが 3D コントロールにヘッド関連の転送関数 (HRTF) を使用することを示します。このビットが設定されている場合は、KSDSOUND_BUFFER_CTRL_3D ビットも設定する必要があります。

KSDSOUND_BUFFER_CTRL_PAN

バッファーにパン制御機能があることを示します。このビットが設定されている場合、バッファーを表すピンは、パンを制御するボリュームノード (KSNODETYPE_VOLUME) を実装します。詳細については、「DirectSound Node-Ordering 要件を参照してください。

KSDSOUND_BUFFER_CTRL_VOLUME

バッファーにボリューム制御機能があることを示します。このビットが設定されている場合、バッファーを表すピンは、ストリームのボリュームレベルを制御するボリュームノード (KSNODETYPE_VOLUME) を実装します。

KSDSOUND_BUFFER_CTRL_POSITIONNOTIFY

バッファーに位置通知機能があることを示します。このビットが設定されている場合、バッファーを表すピンは、KSPROPERTY_AUDIO_POSITION プロパティをサポートします。

WaveFormatEx

バッファーのウェーブデータ形式を指定します。このメンバーは、WAVEFORMATEX 型の構造体です。

備考

KSDATAFORMAT_DSOUND 構造体には、KSDSOUND_BUFFERDESC構造体である BufferDesc メンバーが含まれています。

KSDSOUND_BUFFERDESC構造体の WaveFormatEx メンバーは、追加の形式情報 (チャネル構成マスクなど) を含むように拡張できます。詳細については、WAVEFORMATEXTENSIBLE を参照してください。

必要条件

要件	価値
ヘッダー	ksmedia.h (Ksmedia.h を含む)

次の方法で共有