KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
La propiedad KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR especifica el factor de distancia que se debe aplicar a cualquier valor de distancia.
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
Sí |
Sí |
Anclar |
FLOAT |
El valor de propiedad (datos de operación) es de tipo FLOAT y especifica el factor de distancia.
Valor devuelto
Una solicitud de propiedad KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.
Observaciones
Las distancias de KSPROPSETID_DirectSound3DBuffer y propiedades de KSPROPSETID_DirectSound3DListener se expresan en unidades de medidores por un factor de distancia.
De forma predeterminada, el factor de distancia es 1 y las distancias se expresan en metros. (Además, las unidades de velocidad predeterminadas son medidores por segundo).
Un cliente puede cambiar las unidades de distancia de las propiedades de KSPROPSETID_DirectSound3DBuffer y KSPROPSETID_DirectSound3DListener enviando una solicitud de propiedad set-property de KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR que especifica un factor de distancia diferente.
DirectSound usa esta propiedad para implementar los métodos IDirectSound3DListener::GetDistanceFactor e IDirectSound3DListener::SetDistanceFactor, que se describen en la documentación de Microsoft Windows SDK.
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |