KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
La proprietà KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR specifica il fattore di distanza che deve essere applicato a qualsiasi valore di distanza.
Tabella riepilogo utilizzo
Recupero | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
---|---|---|---|---|
Sì |
Sì |
Aggiungi (Blocca) |
FLOAT |
Il valore della proprietà (dati dell'operazione) è di tipo FLOAT e specifica il fattore di distanza.
Valore restituito
Una richiesta di proprietà KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
Le distanze per le proprietà KSPROPSETID_DirectSound3DBuffer e KSPROPSETID_DirectSound3DListener sono espresse in unità di metri volte a un fattore di distanza.
Per impostazione predefinita, il fattore di distanza è 1 e le distanze vengono pertanto espresse in metri. Inoltre, le unità di velocità predefinite sono metri al secondo.
Un client può modificare le unità di distanza per le proprietà KSPROPSETID_DirectSound3DBuffer e KSPROPSETID_DirectSound3DListener inviando una richiesta di proprietà set KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR che specifica un fattore di distanza diverso.
DirectSound usa questa proprietà per implementare i metodi IDirectSound3DListener::GetDistanceFactor e IDirectSound3DListener::SetDistanceFactor, descritti nella documentazione di Microsoft Windows SDK.
Requisiti
Intestazione |
Ksmedia.h (include Ksmedia.h) |