Interface IAudioStreamVolume (audioclient.h)

L’interface IAudioStreamVolume permet à un client de contrôler et de surveiller les niveaux de volume de tous les canaux d’un flux audio. Le client obtient une référence à l’interface IAudioStreamVolume sur un objet de flux en appelant la méthode IAudioClient ::GetService avec le paramètre riid défini sur REFIID IID_IAudioStreamVolume.

Le niveau de volume effectif de n’importe quel canal dans le sous-mix de session, tel qu’il a été entendu par les intervenants, est le produit des quatre facteurs de niveau volume suivants :

  • Niveaux de volume par canal des flux dans la session, que les clients peuvent contrôler via les méthodes de l’interface IAudioStreamVolume .
  • Niveau de volume par canal de la session, que les clients peuvent contrôler via les méthodes de l’interface IChannelAudioVolume .
  • Le master niveau de volume de la session, que les clients peuvent contrôler via les méthodes de l’interface ISimpleAudioVolume.
  • Niveau de volume basé sur une stratégie de la session, que le système affecte dynamiquement à la session à mesure que la combinaison globale change.
Chacun des quatre facteurs de niveau volume de la liste précédente est une valeur comprise entre 0,0 et 1,0, où 0,0 indique le silence et 1,0 indique le volume complet (aucune atténuation). Le niveau de volume effectif est également une valeur comprise entre 0,0 et 1,0.

Lors de la libération d’une interface IAudioStreamVolume instance, le client doit appeler la méthode Release de l’interface à partir du même thread que l’appel à IAudioClient ::GetService qui a créé l’objet.

L’interface IAudioStreamVolume contrôle les volumes de canal dans un flux audio en mode partagé. Cette interface ne fonctionne pas avec les flux en mode exclusif. Pour plus d’informations sur les contrôles de volume pour les flux en mode exclusif, consultez API EndpointVolume.

Héritage

L’interface IAudioStreamVolume hérite de l’interface IUnknown. IAudioStreamVolume a également les types de membres suivants :

Méthodes

L’interface IAudioStreamVolume possède ces méthodes.

 
IAudioStreamVolume ::GetAllVolumes

La méthode GetAllVolumes récupère les niveaux de volume de tous les canaux du flux audio.
IAudioStreamVolume ::GetChannelCount

La méthode GetChannelCount récupère le nombre de canaux dans le flux audio.
IAudioStreamVolume ::GetChannelVolume

La méthode GetChannelVolume récupère le niveau de volume du canal spécifié dans le flux audio.
IAudioStreamVolume ::SetAllVolumes

La méthode SetAllVolumes définit les niveaux de volume individuels pour tous les canaux du flux audio.
IAudioStreamVolume ::SetChannelVolume

La méthode SetChannelVolume définit le niveau de volume du canal spécifié dans le flux audio.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête audioclient.h

Voir aussi

Interfaces audio principales

IAudioClient ::GetService

IChannelAudioVolume, interface

ISimpleAudioVolume, interface

WASAPI