Edit

KSDS3D_LISTENER_ALL structure (ksmedia.h)

  • Article

The KSDS3D_LISTENER_ALL structure specifies all the properties of the DirectSound 3D listener. This structure is used to get or set the data value for the KSPROPERTY_DIRECTSOUND3DLISTENER_ALL property.

Syntax

typedef struct {
  DS3DVECTOR Position;
  DS3DVECTOR Velocity;
  DS3DVECTOR OrientFront;
  DS3DVECTOR OrientTop;
  FLOAT      DistanceFactor;
  FLOAT      RolloffFactor;
  FLOAT      DopplerFactor;
} KSDS3D_LISTENER_ALL, *PKSDS3D_LISTENER_ALL;

Members

Position

Specifies the position vector of the 3D listener. This member is a structure of type DS3DVECTOR.

Velocity

Specifies the velocity vector of the 3D listener. This member is a structure of type DS3DVECTOR.

OrientFront

Specifies the front orientation vector of the 3D listener. This member is a structure of type DS3DVECTOR.

OrientTop

Specifies the top orientation vector of the 3D listener. This member is a structure of type DS3DVECTOR.

DistanceFactor

Specifies the distance factor for the 3D listener.

RolloffFactor

Specifies the rolloff factor for the 3D listener.

DopplerFactor

Specifies the Doppler factor for the 3D listener.

Remarks

This structure is similar to the DS3DBUFFER structure that is described in the Microsoft Windows SDK documentation. The Windows SDK documentation also discusses the distance, rolloff, and Doppler factors for DirectSound 3D listeners.

DirectSound uses this property to implement the IDirectSound3DListener::GetAllParameters and IDirectSound3DListener::SetAllParameters methods, which are described in the Windows SDK documentation.

Requirements

Requirement Value
Header ksmedia.h (include Ksmedia.h)

See also

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DLISTENER_ALL