DS3DBUFFER

The DS3DBUFFER structure contains all information necessary to uniquely describe the location, orientation, and motion of a 3-D sound buffer. This structure is used with the IDirectSound3DBuffer::GetAllParameters and IDirectSound3DBuffer::SetAllParameters methods.

typedef struct { 
    DWORD     dwSize; 
    D3DVECTOR  vPosition; 
    D3DVECTOR  vVelocity; 
    DWORD     dwInsideConeAngle; 
    DWORD     dwOutsideConeAngle; 
    D3DVECTOR  vConeOrientation; 
    LONG      lConeOutsideVolume; 
    D3DVALUE     flMinDistance; 
    D3DVALUE     flMaxDistance; 
    DWORD     dwMode; 
} DS3DBUFFER, *LPDS3DBUFFER;
 
typedef const DS3DBUFFER *LPCDS3DBUFFER;
 

Members

dwSize

Size of the structure, in bytes. This member must be initialized before the structure is used.

vPosition

A D3DVECTOR structure that describes the current position of the 3-D sound buffer.

vVelocity

A D3DVECTOR structure that describes the current velocity of the 3-D sound buffer.

dwInsideConeAngle

The angle of the inside sound projection cone.

dwOutsideConeAngle

The angle of the outside sound projection cone.

vConeOrientation

A D3DVECTOR structure that describes the current orientation of this 3-D buffer's sound projection cone.

lConeOutsideVolume

The cone outside volume.

flMinDistance

The minimum distance.

flMaxDistance

The maximum distance.

dwMode

The 3-D sound processing mode to be set.

DS3DMODE_DISABLE
	3-D sound processing is disabled. The sound will appear to originate from the center of the listener's head.
DS3DMODE_HEADRELATIVE
	Sound parameters (position, velocity, and orientation) are relative to the listener's parameters. In this mode, the absolute parameters of the sound are updated automatically as the listener's parameters change, so that the relative parameters remain constant.
DS3DMODE_NORMAL
	Normal processing. This is the default mode.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in dsound.h.