fonction mixerGetLineControlsA (mmeapi.h)

  • Article

La fonction mixerGetLineControls récupère un ou plusieurs contrôles associés à une ligne audio.

Syntaxe

MMRESULT mixerGetLineControlsA(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSA pmxlc,
  DWORD                fdwControls
);

Paramètres

hmxobj

Gérez l’objet d’appareil de mixage en cours de requête.

pmxlc

Pointeur vers une structure MIXERLINECONTROLS . Cette structure est utilisée pour référencer une ou plusieurs structures MIXERCONTROL à remplir d’informations sur les contrôles associés à une ligne audio. Le membre cbStruct de la structure MIXERLINECONTROLS doit toujours être initialisé pour être la taille, en octets, de la structure MIXERLINECONTROLS .

fdwControls

Indicateurs permettant de récupérer des informations sur un ou plusieurs contrôles associés à une ligne audio. Les valeurs suivantes sont définies.

Valeur Signification
MIXER_GETLINECONTROLSF_ALL Le paramètre pmxlc fait référence à une liste de structures MIXERCONTROL qui recevront des informations sur tous les contrôles associés à la ligne audio identifiée par le membre dwLineID de la structure MIXERLINECONTROLS . Le membre cControls doit être initialisé au nombre de contrôles associés à la ligne. Ce nombre est récupéré à partir du membre cControls de la structure MIXERLINE retournée par la fonction mixerGetLineInfo . Le membre cbmxctrl doit être initialisé à la taille, en octets, d’une seule structure MIXERCONTROL . Le membre pamxctrl doit pointer vers la première structure MIXERCONTROL à remplir. Les membres dwControlID et dwControlType sont ignorés pour cette requête.
MIXER_GETLINECONTROLSF_ONEBYID Le paramètre pmxlc fait référence à une structure MIXERCONTROL unique qui recevra des informations sur le contrôle identifié par le membre dwControlID de la structure MIXERLINECONTROLS . Le membre cControls doit être initialisé sur 1. Le membre cbmxctrl doit être initialisé à la taille, en octets, d’une seule structure MIXERCONTROL . Le membre pamxctrl doit pointer vers une structure MIXERCONTROL à remplir. Les membres dwLineID et dwControlType sont ignorés pour cette requête. Cette requête est généralement utilisée pour actualiser un contrôle après avoir reçu un message de notification de modification de contrôle MM_MIXM_CONTROL_CHANGE par le rappel défini par l’utilisateur (voir mixerOpen).
MIXER_GETLINECONTROLSF_ONEBYTYPE La fonction mixerGetLineControls récupère des informations sur le premier contrôle d’une classe spécifique pour la ligne audio interrogée. Le paramètre pmxlc fait référence à une structure MIXERCONTROL unique qui recevra des informations sur le contrôle spécifique. La ligne audio est identifiée par le membre dwLineID . La classe de contrôle est spécifiée dans le membre dwControlType de la structure MIXERLINECONTROLS . Le membre dwControlID est ignoré pour cette requête. Cette requête peut être utilisée par une application pour obtenir des informations sur un seul contrôle associé à une ligne. Par exemple, vous pouvez souhaiter que votre application utilise un compteur de pointe uniquement à partir d’une ligne de sortie audio de forme d’onde.
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. 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
MIXERR_INVALCONTROL
 La référence de contrôle n’est pas valide.
MIXERR_INVALLINE
 La référence de ligne audio 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 appareil de mixage n’est disponible pour l’objet spécifié par hmxobj.

Remarques

Notes

L’en-tête mmeapi.h définit mixerGetLineControls comme 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

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 de mixage audio

Mixeurs audio