Edit

KSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE

  • Article

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

Usage Summary Table

Get Set Target Property descriptor type Property 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