DS3DLISTENER

The DS3DLISTENER structure describes the 3-D world parameters and the position of the listener. This structure is used with the IDirectSound3DListener8::GetAllParameters and IDirectSound3DListener8::SetAllParameters methods.

Syntax

typedef struct { 
  DWORD      dwSize; 
  D3DVECTOR  vPosition; 
  D3DVECTOR  vVelocity; 
  D3DVECTOR  vOrientFront; 
  D3DVECTOR  vOrientTop; 
  D3DVALUE   flDistanceFactor; 
  D3DVALUE   flRolloffFactor; 
  D3DVALUE   flDopplerFactor; 
} DS3DLISTENER, *LPDS3DLISTENER;

typedef const DS3DLISTENER *LPCDS3DLISTENER;

Members

dwSize

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

vPosition

D3DVECTOR structure that describes the listener's position.

vVelocity

D3DVECTOR structure that describes the listener's velocity.

vOrientFront

D3DVECTOR structure that describes the listener's front orientation.

vOrientTop

D3DVECTOR structure that describes the listener's top orientation.

flDistanceFactor

Number of meters in a vector unit.

flRolloffFactor

Ratio of attenuation over distance to that in the real world.

flDopplerFactor

Ratio of Doppler effect to that in the real world.

Requirements

  Header: Declared in Dsound.h.

See Also

• DirectSound 3-D Listeners