KSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE
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 |
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) |