auxSetVolume, fonction (mmeapi.h)

  • Article

La fonction auxSetVolume définit le volume du périphérique de sortie auxiliaire spécifié.

Syntaxe

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

Paramètres

uDeviceID

Identificateur du périphérique de sortie auxiliaire à interroger. Les identificateurs d’appareil sont déterminés implicitement à partir du nombre d’appareils présents dans le système. Les valeurs d’identificateur d’appareil sont comprises entre zéro et un de moins que le nombre d’appareils présents. Utilisez la fonction auxGetNumDevs pour déterminer le nombre d’appareils auxiliaires dans le système.

dwVolume

Spécifie le nouveau paramètre de volume. Le mot d’ordre inférieur spécifie le paramètre de volume de canal gauche, et le mot d’ordre supérieur spécifie le paramètre de canal droit. Une valeur de 0xFFFF représente le volume complet, et une valeur de 0x0000 est silence.

Si un appareil ne prend pas en charge à la fois le contrôle de volume gauche et droit, le mot dwVolume de bas ordre spécifie le niveau de volume et le mot d’ordre supérieur est ignoré.

Valeur retournée

Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour Description
MMSYSERR_BADDEVICEID
 L’identificateur d’appareil spécifié est hors limites.

Remarques

Tous les appareils ne prennent pas en charge le contrôle du volume. Pour déterminer si l’appareil prend en charge le contrôle de volume, utilisez l’indicateur AUXCAPS_VOLUME pour tester le membre dwSupport de la structure AUXCAPS (rempli par la fonction auxGetDevCaps ).

Pour déterminer si l’appareil prend en charge le contrôle du volume sur les canaux gauche et droit, utilisez l’indicateur AUXCAPS_LRVOLUME pour tester le membre dwSupport de la structure AUXCAPS (rempli par auxGetDevCaps).

La plupart des appareils ne prennent pas en charge les 16 bits complets du contrôle au niveau du volume et utilisent uniquement les bits d’ordre élevé du paramètre de volume demandé. Par exemple, pour un appareil qui prend en charge 4 bits de contrôle de volume, les valeurs de niveau de volume demandées de 0x4000, 0x4FFF et 0x43BE produisent le même paramètre de volume physique, 0x4000. La fonction auxGetVolume retourne le paramètre 16 bits complet défini avec auxSetVolume.

Les paramètres de volume sont interprétés logarithmiquement. Cela signifie que 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mmeapi.h (inclure Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll

Voir aussi

Waveform Audio

Fonctions de forme d’onde