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