KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR

Die eigenschaft KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR gibt den Rollofffaktor für einen 3D-Listener an.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftendeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Pin	KSNODEPROPERTY	GLEITKOMMAZAHL

Der Eigenschaftswert (Vorgangsdaten) ist vom Typ FLOAT und gibt den Rollofffaktor an. Der Rollofffaktor kann zwischen DS3D_MINROLLOFFFACTOR und DS3D_MAXROLLOFFFACTOR liegen, die als 0,0 bzw. 10,0 definiert sind. Der Standardrollofffaktor ist DS3D_DEFAULTROLLOFFFACTOR, der als 1.0 definiert ist.

Rückgabewert

Eine KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück.

Bemerkungen

Rolloff ist die Menge der Dämpfung, die auf Sounds angewendet wird, basierend auf dem Abstand des Hörers von der Soundquelle. Ein Rolloff-Faktor von 0 bedeutet, dass keine Dämpfung auf einen Sound angewendet wird, unabhängig von seinem Abstand zum Hörer. Faktoren größer als 1 übertreiben die reale Dämpfung des Klangs mit der Entfernung.

DirectSound verwendet diese Eigenschaft, um die Methoden IDirectSound3DListener::GetRolloffFactor und IDirectSound3DListener::SetRolloffFactor zu implementieren, die in der Microsoft Windows SDK-Dokumentation beschrieben werden.

Anforderungen

Header

Ksmedia.h (einschließlich Ksmedia.h)

Siehe auch

KSNODEPROPERTY