KSPROPERTY_DIRECTSOUND3DLISTENER_POSITION

The KSPROPERTY_DIRECTSOUND3DLISTENER_POSITION property specifies the position of a 3D listener.

Usage Summary Table

Get Set Target Property descriptor type Property value type

Yes

Yes

Pin

KSNODEPROPERTY

DS3DVECTOR

The property value (operation data) is a structure of type DS3DVECTOR that specifies the listener's position. Position coordinates are expressed in the current distance units. For information about distance units, see KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR.

Return Value

A KSPROPERTY_DIRECTSOUND3DLISTENER_POSITION property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.

Remarks

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

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

KSNODEPROPERTY

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR