共用方式為

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