共用方式為

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 會使用此屬性來實作 Windows SDK 檔中所述的 IDirectSound3DBuffer：：GetAllParameters 和 IDirectSound3DBuffer：：SetAllParameters 方法。

此結構的成員類似於 Windows SDK 檔案中針對DS3DBUFFER結構定義的成員。

規格需求

需求 值
標頭 ksmedia.h (包含 Ksmedia.h)

另請參閱

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL