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

Siehe auch

KSNODEPROPERTY