KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR
La proprietà KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR specifica il fattore rolloff 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 rolloff. Il fattore rolloff può variare rispettivamente da DS3D_MINROLLOFFFACTOR a DS3D_MAXROLLOFFFACTOR, definite rispettivamente come 0,0 e 10,0. Il fattore di rolloff predefinito è DS3D_DEFAULTROLLOFFFACTOR, definito come 1,0.
Valore restituito
Una richiesta di proprietà KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
Rolloff è la quantità di attenuazione applicata ai suoni, in base alla distanza del listener dalla fonte sonora. Un fattore rolloff pari a zero significa che non viene applicata alcuna attenuazione a un suono indipendentemente dalla distanza dal listener. I fattori maggiori di 1 esagerano l'attenuazione reale del suono con distanza.
DirectSound usa questa proprietà per implementare i metodi IDirectSound3DListener::GetRolloffFactor e IDirectSound3DListener::SetRolloffFactor, descritti nella documentazione di Microsoft Windows SDK.
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |