KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
Die KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR-Eigenschaft gibt den Abstandsfaktor an, der auf alle Entfernungswerte angewendet werden soll.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftsdeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Ja |
Pin |
GLEITKOMMAZAHL |
Der Eigenschaftswert (Vorgangsdaten) ist vom Typ FLOAT und gibt den Abstandsfaktor an.
Rückgabewert
Eine KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.
Bemerkungen
Entfernungen für KSPROPSETID_DirectSound3DBuffer- und KSPROPSETID_DirectSound3DListener-Eigenschaften werden in Einheiten von Metern mal einem Abstandsfaktor ausgedrückt.
Standardmäßig ist der Abstandsfaktor 1, und Entfernungen werden daher in Metern ausgedrückt. (Außerdem sind die Standardgeschwindigkeitseinheiten Meter pro Sekunde.)
Ein Client kann die Entfernungseinheiten für die KSPROPSETID_DirectSound3DBuffer - und KSPROPSETID_DirectSound3DListener eigenschaften ändern, indem er eine KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR Set-Eigenschaftsanforderung sendet, die einen anderen Entfernungsfaktor angibt.
DirectSound verwendet diese Eigenschaft, um die Methoden IDirectSound3DListener::GetDistanceFactor und IDirectSound3DListener::SetDistanceFactor zu implementieren, die in der Microsoft Windows SDK-Dokumentation beschrieben werden.
Anforderungen
Header |
Ksmedia.h (include Ksmedia.h) |