Partager via


KSPROPERTY_AUDIO_WIDENESS

La propriété KSPROPERTY_AUDIO_WIDENESS spécifie l’étendue (largeur apparente) de l’image stéréo.

Tableau récapitulatif de l’utilisation

Obtenir Définissez Cible Type de descripteur de propriété Type de valeur de propriété

Oui

Oui

Filtrer

KSNODEPROPERTY

ULONG

La valeur de propriété (données d’opération) est de type ULONG et spécifie l’étendue. L’étendue est exprimée sous la forme d’une valeur à point fixe non signée avec une fraction 16 bits. Les valeurs d’étendue suivent une plage linéaire de zéro à 0xFFFFFFFF :

  • La valeur 0x00010000 représente l’unité (100 %), ce qui indique que la largeur de l’image stéréo doit coïncider avec la région encadrée par les haut-parleurs gauche et droit.

  • Pour une valeur supérieure à unity, l’image stéréo doit sembler s’étendre en dehors de la région encadrée par les haut-parleurs gauche et droit.

  • Pour une valeur inférieure à l’unité, la largeur perçue de l’image stéréo doit être inférieure à l’espace entre les haut-parleurs gauche et droit.

  • La valeur zéro indique que le son doit sembler provenir d’une position à mi-chemin entre les haut-parleurs gauche et droit.

La largeur apparente de l’image stéréo doit augmenter de manière linéaire avec des augmentations linéaires de la valeur d’étendue.

Valeur de retour

Une demande de propriété KSPROPERTY_AUDIO_WIDENESS 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

Il s’agit d’une propriété d’un nœud d’étendue (KSNODETYPE_STEREO_WIDE). Un nœud d’étendue peut ajouter de l’espace à un flux stéréo (à deux canaux) existant. Pour obtenir cet effet, le nœud traite le flux pour que certains sons semblent provenir de positions en dehors de la région encadrée par les haut-parleurs gauche et droit.

Spécifications

En-tête

Ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSNODEPROPERTY

KSNODETYPE_STEREO_WIDE