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::GetAllParametersIDirectSound3DBuffer::SetAllParameters 方法。

此結構的成員類似于 Windows SDK 檔中 DS3DBUFFER 結構所定義的成員。

規格需求

   
標頭 ksmedia.h (包含 Ksmedia.h)

另請參閱

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL