KSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE

KSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE

The KSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE property specifies the minimum distance for a 3D sound buffer.

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Pin

KSNODEPROPERTY

FLOAT

 

The property value (operation data) is of type FLOAT and specifies the minimum distance. For information about distance units, see KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR.

Return Value

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

Remarks

At a distance less than the minimum distance from a sound source, the sound volume no longer increases as the distance decreases. For more information about the minimum distance for a DirectSound 3D buffer, see the following in the Microsoft Windows SDK documentation:

  • The flMinDistance member of the DS3DBUFFER structure.

  • The IDirectSound3DBuffer::GetMinDistance and IDirectSound3DBuffer::SetMinDistance methods.

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

KSNODEPROPERTY
KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft