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.
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 |