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à |
---|---|---|---|---|
Sì |
Sì |
Aggiungi (Blocca) |
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) |