次の方法で共有

KSDS3D_BUFFER_ALL構造体 (ksmedia.h)

  • [アーティクル]

KSDS3D_BUFFER_ALL構造体は、DirectSound 3D バッファーのすべての 3D 特性を指定します。

構文

typedef struct {
  DS3DVECTOR Position;
  DS3DVECTOR Velocity;
  ULONG      InsideConeAngle;
  ULONG      OutsideConeAngle;
  DS3DVECTOR ConeOrientation;
  LONG       ConeOutsideVolume;
  FLOAT      MinDistance;
  FLOAT      MaxDistance;
  ULONG      Mode;
} KSDS3D_BUFFER_ALL, *PKSDS3D_BUFFER_ALL;

メンバーズ

Position

3D サウンド バッファーの x、y、z 位置の座標を指定します。 このメンバーは、DS3DVECTOR型の構造体です。

Velocity

3D サウンド バッファーの x、y、z 速度コンポーネントを指定します。 このメンバーは、DS3DVECTOR型の構造体です。

InsideConeAngle

内側のサウンド プロジェクション コーンの角度を度単位で指定します。

OutsideConeAngle

外音投影円錐の角度を度単位で指定します。

ConeOrientation

3D バッファーのサウンド プロジェクション コーンの向きの x、y、z の各コンポーネントを指定します。 このメンバーは、DS3DVECTOR型の構造体です。

ConeOutsideVolume

ボリュームの外側の円錐を指定します。

MinDistance

話者とリスナーの間の最小距離を指定します。 (Microsoft Windows SDK ドキュメントの DirectSound 3D バッファーの最小距離と最大距離の説明を参照してください)。

MaxDistance

スピーカーとリスナーの間の最大距離を指定します。

Mode

3D サウンド処理モードを指定します。 ヘッダー ファイル Dsound.h から次のいずれかの値を指定できます。

  • DS3DMODE_DISABLE
  • DS3DMODE_HEADRELATIVE
  • DS3DMODE_NORMAL
これらのパラメーターの意味については、Microsoft Windows SDK ドキュメントの DS3DBUFFER 構造体の dwMode メンバーの説明を参照してください。

備考

この構造体は、KSPROPERTY_DIRECTSOUND3DBUFFER_ALL プロパティのデータ値を設定または取得するために使用されます。 DirectSound では、このプロパティを使用して、IDirectSound3DBuffer::GetAllParameters および IDirectSound3DBuffer::SetAllParameters メソッドを実装します。これは、Windows SDK ドキュメントで説明されています。

この構造体のメンバーは、Windows SDK ドキュメントのDS3DBUFFER構造に対して定義されているものと似ています。

必要条件

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

関連項目

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL