KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR

La proprietà KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR specifica il fattore Doppler per un listener 3D.

Tabella riepilogo utilizzo

Recupero Set Destinazione Tipo di descrittore delle proprietà Tipo di valore della proprietà

Aggiungi (Blocca)

KSNODEPROPERTY

FLOAT

Il valore della proprietà (dati dell'operazione) è di tipo FLOAT e specifica il fattore Doppler. Il fattore Doppler può variare rispettivamente da DS3D_MINDOPPLERFACTOR a DS3D_MAXDOPPLERFACTOR, definiti rispettivamente come 0,0 e 10,0. Il fattore predefinito è DS3D_DEFAULTDOPPLERFACTOR, definito come 1,0.

Valore restituito

Una richiesta di proprietà KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.

Commenti

Questa proprietà specifica il fattore Doppler applicato sia al listener 3D che al buffer audio 3D.

Un fattore Doppler pari a zero significa che nessun cambio Doppler viene applicato a un suono indipendentemente dalla velocità del listener o del buffer audio. Fattori maggiori di 1 esagerare la quantità di spostamento doppler che si verificherebbe nel mondo reale.

DirectSound usa questa proprietà per implementare i metodi IDirectSound3DListener::GetDopplerFactor e IDirectSound3DListener::SetDopplerFactor, descritti nella documentazione di Microsoft Windows SDK.

Requisiti

Intestazione

Ksmedia.h (includere Ksmedia.h)

Vedere anche

KSNODEPROPERTY