KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
La propriété KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR spécifie le facteur de distance qui doit être appliqué à toutes les valeurs de distance.
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 distance.
Valeur de retour
Une demande de propriété KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la demande retourne une erreur appropriée status code.
Notes
Les distances pour les propriétés KSPROPSETID_DirectSound3DBuffer et KSPROPSETID_DirectSound3DListener sont exprimées en unités de mètres multipliées par un facteur de distance.
Par défaut, le facteur de distance est 1 et les distances sont donc exprimées en mètres. (En outre, les unités de vitesse par défaut sont des mètres par seconde.)
Un client peut modifier les unités de distance pour les propriétés KSPROPSETID_DirectSound3DBuffer et KSPROPSETID_DirectSound3DListener en envoyant une KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR demande set-property qui spécifie un facteur de distance différent.
DirectSound utilise cette propriété pour implémenter les méthodes IDirectSound3DListener::GetDistanceFactor et IDirectSound3DListener::SetDistanceFactor, qui sont décrites dans la documentation Microsoft Windows SDK.
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |