KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR
La propriété KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR spécifie le facteur de rolloff d’un écouteur 3D.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Oui |
Épingle |
FLOAT |
La valeur de propriété (données d’opération) est de type FLOAT et spécifie le facteur de rolloff. Le facteur de substitution peut aller de DS3D_MINROLLOFFFACTOR à DS3D_MAXROLLOFFFACTOR, qui sont définis comme 0,0 et 10,0 respectivement. Le facteur de substitution par défaut est DS3D_DEFAULTROLLOFFFACTOR, qui est défini comme 1.0.
Valeur de retour
Une demande de propriété KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne une erreur appropriée status code.
Notes
Rolloff est la quantité d’atténuation appliquée aux sons, en fonction de la distance de l’écouteur par rapport à la source du son. Un facteur de rolloff égal à zéro signifie qu’aucune atténuation n’est appliquée à un son, quelle que soit sa distance par rapport à l’écouteur. Les facteurs supérieurs à 1 exagèrent l’atténuation réelle du son avec la distance.
DirectSound utilise cette propriété pour implémenter les méthodes IDirectSound3DListener::GetRolloffFactor et IDirectSound3DListener::SetRolloffFactor, qui sont décrites dans la documentation Microsoft Windows SDK.
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |