KSPROPERTY_DIRECTSOUND3DBUFFER_MAXDISTANCE

The KSPROPERTY_DIRECTSOUND3DBUFFER_MAXDISTANCE property specifies the maximum 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 maximum distance. For information about distance units, see KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR.

Return Value

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.

Remarks

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.

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

KSNODEPROPERTY
KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR

 

 

Send comments about this topic to Microsoft

Show: