|
|
|
The KSPROPERTY_DIRECTSOUND3DLISTENER_POSITION property specifies the position of a 3D listener.
| 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 on distance units, see KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR.
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.
Declared in ksmedia.h. Include ksmedia.h.
DirectSound uses this property to implement the IDirectSound3DListener::GetPosition and IDirectSound3DListener::SetPosition methods, which are described in the Platform SDK documentation.
KSNODEPROPERTY, DS3DVECTOR, KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR