KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR
Die eigenschaft KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR gibt den Dopplerfaktor 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 Dopplerfaktor an. Der Dopplerfaktor kann von DS3D_MINDOPPLERFACTOR bis zu DS3D_MAXDOPPLERFACTOR reichen, die als 0,0 bzw. 10,0 definiert sind. Der Standardfaktor ist DS3D_DEFAULTDOPPLERFACTOR, der als 1.0 definiert ist.
Rückgabewert
Eine KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR-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
Diese Eigenschaft gibt den Dopplerfaktor an, der sowohl auf den 3D-Listener als auch auf den 3D-Soundpuffer angewendet wird.
Ein Dopplerfaktor von 0 bedeutet, dass keine Dopplerverschiebung auf einen Sound angewendet wird, unabhängig von der Geschwindigkeit des Listeners oder Des Soundpuffers. Faktoren größer als 1 übertreiben die Menge der Dopplerverschiebung, die in der realen Welt auftreten würde.
DirectSound verwendet diese Eigenschaft, um die Methoden IDirectSound3DListener::GetDopplerFactor und IDirectSound3DListener::SetDopplerFactor zu implementieren, die in der Microsoft Windows SDK-Dokumentation beschrieben werden.
Anforderungen
Header |
Ksmedia.h (einschließlich Ksmedia.h) |