fonction midiOutGetVolume (mmeapi.h)

  • Article

La fonction midiOutGetVolume récupère le paramètre de volume actuel d’un appareil de sortie MIDI.

Syntaxe

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

Paramètres

hmo

Gérez vers un appareil de sortie MIDI ouvert. Ce paramètre peut également contenir le handle d’un flux MIDI, tant qu’il est converti en HMIDIOUT. Ce paramètre peut également être un identificateur d’appareil.

pdwVolume

Pointeur vers l’emplacement pour contenir le paramètre de volume actuel. Le mot de bas ordre de cet emplacement contient le paramètre de volume de canal gauche, et le mot d’ordre élevé contient le paramètre de canal de droite. 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 du volume gauche et droit, le mot d’ordre bas de l’emplacement spécifié contient le niveau de volume mono.

Toute valeur définie à l’aide de la fonction midiOutSetVolume est retournée, que l’appareil prenne ou en charge cette valeur.

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_INVALHANDLE
 Le handle d’appareil spécifié n’est pas valide.
MMSYSERR_INVALPARAM
 Le pointeur ou la structure spécifiés n’est pas valide.
MMSYSERR_NOMEM
 Le système ne peut pas allouer ou verrouiller la mémoire.
MMSYSERR_NOTSUPPORTED
 La fonction n’est pas prise en charge.

Remarques

Si un identificateur d’appareil est utilisé, le résultat de l’appel midiOutGetVolume et les informations retournées dans lpdwVolume s’appliquent à toutes les instances de l’appareil. Si un handle d’appareil est utilisé, le résultat et les informations retournées s’appliquent uniquement au instance de l’appareil référencé par le handle d’appareil.

Tous les appareils ne prennent pas en charge le contrôle du volume. Vous pouvez déterminer si un appareil prend en charge le contrôle de volume en interrogeant l’appareil à l’aide de la fonction midiOutGetDevCaps et en spécifiant l’indicateur MIDICAPS_VOLUME.

Vous pouvez également déterminer si l’appareil prend en charge le contrôle du volume sur les canaux gauche et droit en interrogeant l’appareil à l’aide de la fonction midiOutGetDevCaps et en spécifiant l’indicateur MIDICAPS_LRVOLUME.

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

Fonctions MIDI