Modification du volume de lecture Waveform-Audio
[La fonctionnalité associée à cette page, Waveform Audio, est une fonctionnalité héritée. Il a été remplacé par WASAPI et Audio Graphs. Les graphiques WASAPI et Audio ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise WASAPI et Audio Graphs au lieu de l’audio waveform, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
Windows fournit les fonctions suivantes pour interroger et définir le niveau de volume des périphériques de sortie audio de forme d’onde.
| Fonction | Description |
|---|---|
| waveOutGetVolume | Récupère le niveau de volume actuel de l’appareil de sortie audio de forme d’onde spécifié. |
| waveOutSetVolume | Définit le niveau de volume du périphérique de sortie audio de forme d’onde spécifié. |
Tous les appareils audio de forme d’onde ne prennent pas en charge les modifications de volume. Certains appareils prennent en charge le contrôle de volume individuel sur les canaux gauche et droit. Pour plus d’informations sur la façon de déterminer les fonctionnalités de contrôle de volume des appareils audio de forme d’onde, consultez Appareils et types de données.
Certaines applications permettent à l’utilisateur de contrôler le volume de tous les périphériques audio d’un système. (De nombreuses applications de ce type utilisent les services de mixage audio ; pour plus d’informations, consultez Mixers audio.) À moins que votre application ne soit capable de ce type de contrôle de volume master, vous devez ouvrir un périphérique audio avant de modifier son volume. Vous devez également interroger le niveau du volume avant de le modifier et restaurer le niveau de volume à son niveau précédent dès que possible.
Le volume est spécifié dans une valeur de mot double. Lorsque le format audio est stéréo, les 16 bits supérieurs spécifient le volume relatif du canal droit et les 16 bits inférieurs spécifient le volume relatif du canal gauche. Pour les appareils qui ne prennent pas en charge le contrôle du volume des canaux gauche et droit, les 16 bits inférieurs spécifient le niveau de volume, et les 16 bits supérieurs sont ignorés.
Les valeurs au niveau du volume vont de 0x0 (silence) à 0xFFFF (volume maximal) et sont interprétées de manière logarithmique. L’augmentation du volume perçue est la même lors de l’augmentation du niveau de volume de 0x5000 à 0x6000 que de 0x4000 à 0x5000.