ksmedia.h) (KSDS3D_BUFFER_ALL 结构

  • 项目

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 结构定义的成员。

要求

要求 值
Header ksmedia.h (包括 Ksmedia.h)

另请参阅

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL