waveOutGetVolume, fonction (mmeapi.h)
La fonction waveOutGetVolume récupère le niveau de volume actuel du périphérique de sortie audio de forme d’onde spécifié.
Syntaxe
MMRESULT waveOutGetVolume(
HWAVEOUT hwo,
LPDWORD pdwVolume
);
Paramètres
hwo
Handle vers un périphérique de sortie audio de forme d’onde ouverte. Ce paramètre peut également être un identificateur d’appareil.
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 à la fois le contrôle de volume gauche et droit, le mot d’ordre inférieur de l’emplacement spécifié contient le niveau de volume mono.
Le ou les paramètres 16 bits complets définis avec la fonction waveOutSetVolume 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 |
|---|---|
|
Le handle d’appareil spécifié n’est pas valide. |
|
Aucun pilote de périphérique n’est présent. |
|
Impossible d’allouer ou de verrouiller la mémoire. |
|
La fonction n’est pas prise en charge. |
Notes
Si un identificateur d’appareil est utilisé, le résultat de l’appel waveOutGetVolume et les informations retournées dans pdwVolume s’appliquent à toutes les instances de l’appareil. Si un handle d’appareil est utilisé, le résultat et les informations retournés s’appliquent uniquement au instance de l’appareil référencé par le handle d’appareil.
Tous les appareils ne prennent pas en charge les modifications de volume. Pour déterminer si l’appareil prend en charge le contrôle de volume, utilisez l’indicateur WAVECAPS_VOLUME pour tester le membre dwSupport de la structure WAVEOUTCAPS (rempli par la fonction waveOutGetDevCaps ).
Pour déterminer si l’appareil prend en charge le contrôle du volume des canaux gauche et droit, utilisez l’indicateur WAVECAPS_LRVOLUME pour tester le membre dwSupport de la structure WAVEOUTCAPS (rempli par waveOutGetDevCaps).
Les paramètres de volume sont interprétés logarithmiquement. Cela signifie que l’augmentation du volume perçue est la même lorsque vous augmentez le niveau de volume de 0x5000 à 0x6000 que de 0x4000 à 0x5000.
Spécifications
| 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 |