fonction mixerGetControlDetailsA (mmeapi.h)
La fonction mixerGetControlDetails récupère les détails d’un seul contrôle associé à une ligne audio.
Syntaxe
MMRESULT mixerGetControlDetailsA(
HMIXEROBJ hmxobj,
LPMIXERCONTROLDETAILS pmxcd,
DWORD fdwDetails
);
Paramètres
hmxobj
Gérez l’objet d’appareil de mixage 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 dans la plage de zéro à un inférieur au nombre d’appareils retournés par la fonction auxGetNumDevs . |
| MIXER_OBJECTF_HMIDIIN | Le paramètre hmxobj est le handle d’un périphérique d’entrée MIDI (Interface numérique d’instrument de musique). 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 d’appareil de mélangeur retournée par la fonction mixerOpen . Cet indicateur est facultatif. |
| MIXER_OBJECTF_HWAVEIN | Le paramètre hmxobj est une poignée d’entrée audio de forme d’onde retournée par la fonction waveInOpen . |
| MIXER_OBJECTF_HWAVEOUT | Le paramètre hmxobj est une poignée de sortie audio de forme d’onde retournée 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 inférieur au nombre d’appareils retournés par la fonction midiOutGetNumDevs . |
| MIXER_OBJECTF_MIXER | Le paramètre hmxobj est l’identificateur d’un appareil de mélangeur dans la plage de zéro à un inférieur au 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 inférieur au nombre d’appareils retournés par la fonction waveInGetNumDevs . |
| MIXER_OBJECTF_WAVEOUT | Le paramètre hmxobj est l’identificateur d’un appareil de sortie waveform-audio dans la plage de zéro à un inférieur au 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 |
|---|---|
|
La référence de contrôle n’est pas valide. |
|
Le paramètre hmxobj spécifie un identificateur d’appareil non valide. |
|
Un ou plusieurs indicateurs ne sont pas valides. |
|
Le paramètre hmxobj spécifie un handle non valide. |
|
Un ou plusieurs paramètres ne sont pas valides. |
|
Aucun appareil 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 comme un 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. Le mélange 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 |