fonction auxGetVolume (mmeapi.h)

  • Article

La fonction auxGetVolume récupère le paramètre de volume actuel du périphérique de sortie auxiliaire spécifié.

Syntaxe

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

Paramètres

uDeviceID

Identificateur du périphérique de sortie auxiliaire à interroger.

pdwVolume

Pointeur vers une variable à remplir avec le paramètre de volume actuel. Le mot d’ordre inférieur de cet emplacement contient le paramètre de volume de canal gauche, et le mot d’ordre supérieur contient 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 le contrôle de volume gauche et droit, le mot d’ordre inférieur de l’emplacement spécifié contient le niveau de volume.

Les paramètres 16 bits complets définis avec la fonction auxSetVolume sont retournés, que l’appareil prenne en charge ou non les 16 bits complets du contrôle au niveau du volume.

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 un 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 un appareil prend en charge le contrôle de volume sur les canaux gauche et droit, utilisez l’indicateur AUXCAPS_LRVOLUME pour tester le membre dwSupport de la structure AUXCAPS (rempli par auxGetDevCaps).

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