title | description | keywords | topic_type | ms.topic | api_name | api_location | api_type | ms.date | |||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
KSPROPERTY\_DIRECTSOUND3DBUFFER\_MAXDISTANCE |
The KSPROPERTY\_DIRECTSOUND3DBUFFER\_MAXDISTANCE property specifies the maximum distance for a 3D sound buffer. |
|
|
reference |
|
|
|
03/06/2023 |
The KSPROPERTY_DIRECTSOUND3DBUFFER_MAXDISTANCE property specifies the maximum distance for a 3D sound buffer.
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 maximum distance. For information about distance units, see KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR.
A KSPROPERTY_DIRECTSOUND3DBUFFER_MAXDISTANCE property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
At a distance that exceeds the maximum distance from a sound source, the sound from that source is reduced to silence. For more information about the maximum distance for a DirectSound 3D buffer, see the following in the Microsoft Windows SDK documentation:
-
The flMaxDistance member of the DS3DBUFFER structure.
-
The IDirectSound3DBuffer::GetMaxDistance and IDirectSound3DBuffer::SetMaxDistance methods.
Header |
Ksmedia.h (include Ksmedia.h) |