KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR
La propiedad KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR especifica el factor de reversión de un agente de escucha 3D.
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 reversión. El factor de reversión puede oscilar entre DS3D_MINROLLOFFFACTOR y DS3D_MAXROLLOFFFACTOR, que se definen como 0,0 y 10,0 respectivamente. El factor de reversión predeterminado es DS3D_DEFAULTROLLOFFFACTOR, que se define como 1.0.
Valor devuelto
Una solicitud de propiedad KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR 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
Rolloff es la cantidad de atenuación que se aplica a los sonidos, en función de la distancia del agente de escucha desde la fuente de sonido. Un factor de reversión de cero significa que no se aplica ninguna atenuación a un sonido independientemente de su distancia desde el agente de escucha. Factores mayores que 1 exageran la atenuación real del sonido con distancia.
DirectSound usa esta propiedad para implementar los métodos IDirectSound3DListener::GetRolloffFactor e IDirectSound3DListener::SetRolloffFactor, que se describen en la documentación de Microsoft Windows SDK.
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |