Partager via

mixerGetControlDetailsW, fonction (mmeapi.h)

  • Article

La fonction mixerGetControlDetails récupère les détails d’un seul contrôle associé à une ligne audio.

Syntaxe

MMRESULT mixerGetControlDetailsW(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

Paramètres

hmxobj

Handle vers l’objet d’appareil mixer interrogé.

pmxcd

Pointeur vers une structure MIXERCONTROLDETAILS , qui est remplie d’informations d’état sur le contrôle.

fdwDetails

Indicateurs pour récupérer les détails du contrôle. Les valeurs suivantes sont définies.

Valeur Signification
MIXER_GETCONTROLDETAILSF_LISTTEXT Le membre paDetails de la structure MIXERCONTROLDETAILS pointe vers une ou plusieurs structures MIXERCONTROLDETAILS_LISTTEXT pour recevoir des étiquettes de texte pour les contrôles à plusieurs éléments. Une application doit obtenir tous les éléments de texte de liste pour un contrôle à plusieurs éléments à la fois. Cet indicateur ne peut pas être utilisé avec les contrôles MIXERCONTROL_CONTROLTYPE_CUSTOM.
MIXER_GETCONTROLDETAILSF_VALUE Les valeurs actuelles d’un contrôle sont récupérées. Le membre paDetails de la structure MIXERCONTROLDETAILS pointe vers une ou plusieurs structures de détails appropriées pour la classe de contrôle.
MIXER_OBJECTF_AUX Le paramètre hmxobj est un identificateur d’appareil auxiliaire compris entre zéro et un de moins que le nombre d’appareils retourné par la fonction auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN Le paramètre hmxobj est le handle d’un périphérique d’entrée MIDI (Musical Instrument Digital Interface). Ce handle doit avoir été retourné par la fonction midiInOpen .
MIXER_OBJECTF_HMIDIOUT Le paramètre hmxobj est le handle d’un périphérique de sortie MIDI. Ce handle doit avoir été retourné par la fonction midiOutOpen .
MIXER_OBJECTF_HMIXER Le paramètre hmxobj est une poignée de périphérique de mélangeur retournée par la fonction mixerOpen . Cet indicateur est facultatif.
MIXER_OBJECTF_HWAVEIN Le paramètre hmxobj est un handle d’entrée audio de forme d’onde retourné par la fonction waveInOpen .
MIXER_OBJECTF_HWAVEOUT Le paramètre hmxobj est un handle de sortie audio de forme d’onde retourné par la fonction waveOutOpen .
MIXER_OBJECTF_MIDIIN Le paramètre hmxobj est l’identificateur d’un périphérique d’entrée MIDI. Cet identificateur doit être compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction midiInGetNumDevs .
MIXER_OBJECTF_MIDIOUT Le paramètre hmxobj est l’identificateur d’un périphérique de sortie MIDI. Cet identificateur doit être compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction midiOutGetNumDevs .
MIXER_OBJECTF_MIXER Le paramètre hmxobj est l’identificateur d’un appareil mixer compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction mixerGetNumDevs . Cet indicateur est facultatif.
MIXER_OBJECTF_WAVEIN Le paramètre hmxobj est l’identificateur d’un périphérique d’entrée audio de forme d’onde dans la plage de zéro à un de moins que le nombre d’appareils retournés par la fonction waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT Le paramètre hmxobj est l’identificateur d’un appareil de sortie audio de forme d’onde dans la plage de zéro à un de moins que le nombre d’appareils retournés par la fonction waveOutGetNumDevs .

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
MIXERR_INVALCONTROL
 La référence de contrôle n’est pas valide.
MMSYSERR_BADDEVICEID
 Le paramètre hmxobj spécifie un identificateur d’appareil non valide.
MMSYSERR_INVALFLAG
 Un ou plusieurs indicateurs ne sont pas valides.
MMSYSERR_INVALHANDLE
 Le paramètre hmxobj spécifie un handle non valide.
MMSYSERR_INVALPARAM
 Un ou plusieurs paramètres ne sont pas valides.
MMSYSERR_NODRIVER
 Aucun dispositif de mixage n’est disponible pour l’objet spécifié par hmxobj.

Notes

Tous les membres de la structure MIXERCONTROLDETAILS doivent être initialisés avant d’appeler cette fonction.

Notes

L’en-tête mmeapi.h définit mixerGetControlDetails en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

   
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 Mmeapi.h, Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll

Voir aussi

Fonctions de mixage audio

Mixeurs audio