KSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE

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

The property value (operation data) is of type FLOAT and specifies the minimum distance. For information on 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.

Headers

Declared in ksmedia.h. Include ksmedia.h.

Comments

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 on the minimum distance for a DirectSound 3D buffer, see the following in the Platform SDK documentation:

• The flMinDistance member of the DS3DBUFFER structure.
• The IDirectSound3DBuffer::GetMinDistance and IDirectSound3DBuffer::SetMinDistance methods.

See Also

KSNODEPROPERTY, KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR