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à

Aggiungi (Blocca)

KSNODEPROPERTY

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)

Vedere anche

KSNODEPROPERTY