DS3DLISTENER

The DS3DLISTENER structure contains all information necessary to uniquely describe the 3-D world parameters and position of the listener. This structure is used with the IDirectSound3DListener::GetAllParameters and IDirectSound3DListener::SetAllParameters methods.

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, vVelocity, vOrientFront, and vOrientTop

D3DVECTOR structures that describe the listener's position, velocity, front orientation, and top orientation, respectively.

flDistanceFactor, flRolloffFactor, and flDopplerFactor

The current distance, rolloff, and Doppler factors, respectively.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dsound.h.