mixerGetLineInfoA, fonction (mmeapi.h)

La fonction mixerGetLineInfo récupère des informations sur une ligne spécifique d’un appareil de mélangeur.

Syntaxe

MMRESULT mixerGetLineInfoA(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEA pmxl,
  DWORD        fdwInfo
);

Paramètres

hmxobj

Gérez l’objet d’appareil de mixage qui contrôle la ligne audio spécifique.

pmxl

Pointeur vers une structure MIXERLINE . Cette structure est remplie d’informations sur la ligne audio de l’appareil de mixage. Le membre cbStruct doit toujours être initialisé pour être la taille, en octets, de la structure MIXERLINE .

fdwInfo

Indicateurs pour récupérer des informations sur une ligne audio. Les valeurs suivantes sont définies.

Valeur	Signification
MIXER_GETLINEINFOF_COMPONENTTYPE	Le paramètre pmxl reçoit des informations sur la première ligne audio du type spécifié dans le membre dwComponentType de la structure MIXERLINE . Cet indicateur est utilisé pour récupérer des informations sur une ligne audio d’un type de composant spécifique. Les membres de structure restants, sauf cbStruct ne nécessitent pas d’initialisation supplémentaire.
MIXER_GETLINEINFOF_DESTINATION	Le paramètre pmxl reçoit des informations sur la ligne audio de destination spécifiée par le membre dwDestination de la structure MIXERLINE. Cet index varie de zéro à un de moins que la valeur dans les cDestinations membre de la structure MIXERCAPS. Tous les membres de structure restants, sauf cbStruct ne nécessitent aucune initialisation supplémentaire.
MIXER_GETLINEINFOF_LINEID	Le paramètre pmxl reçoit des informations sur la ligne audio spécifiée par le membre dwLineID de la structure MIXERLINE . Il est généralement utilisé pour récupérer des informations mises à jour sur l’état d’une ligne audio. Tous les membres de structure restants, sauf cbStruct ne nécessitent aucune initialisation supplémentaire.
MIXER_GETLINEINFOF_SOURCE	Le paramètre pmxl reçoit des informations sur la ligne audio source spécifiée par le dwDestination et les membres dwSource de la structure MIXERLINE . L’index spécifié par dwDestination varie de zéro à un index inférieur à la valeur dans les membres cDestinations de la structure MIXERCAPS. L’index spécifié par dwSource varie de zéro à un index inférieur à la valeur du membre cConnections de la structure MIXERLINE retournée pour la ligne audio stockée dans le membre dwDestination. Tous les membres de structure restants, sauf cbStruct ne nécessitent aucune initialisation supplémentaire.
MIXER_GETLINEINFOF_TARGETTYPE	Le paramètre pmxl reçoit des informations sur la ligne audio correspondant au membre dwType de la structure cible , membre de la structure MIXERLINE . Cet indicateur est utilisé pour récupérer des informations sur une ligne audio qui gère le type cible (par exemple, MIXERLINE_TARGETTYPE_WAVEOUT). L’application doit initialiser ledwType , wMid, wPid, vDriverVersion et szPname membres de la structure MIXERLINE avant d’appeler mixerGetLineInfo. Toutes ces valeurs peuvent être récupérées à partir des structures de fonctionnalités d’appareil pour tous les appareils multimédias. Les membres de structure restants, sauf cbStruct ne nécessitent pas d’initialisation supplémentaire. Remarque Dans la version ANSI de cette fonction (mixerGetLineInfoA), vous ne pouvez pas utiliser la chaîne ANSI retournée par mixerGetLineInfo ou waveOutGetDevCaps pour la valeur de la chaîne psPname lors de l’appel mixerGetLineInfo avec l’indicateur MIXER_GETLINEINFOF_TARGETTYPE. La raison est qu’une conversion interne vers et depuis Unicode est effectuée, ce qui peut entraîner une perte de données.
MIXER_OBJECTF_AUX	Le paramètre hmxobj est un identificateur d’appareil auxiliaire compris entre zéro et un nombre 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 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 nombre inférieur au 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 se trouver dans la plage de zéro à un nombre inférieur au nombre d’appareils retournés par la fonction midiOutGetNumDevs.
MIXER_OBJECTF_MIXER	Le paramètre hmxobj est un identificateur d’appareil de mélangeur compris entre zéro et un nombre 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 nombre inférieur au nombre d’appareils retournés par la fonction waveInGetNumDevs.
MIXER_OBJECTF_WAVEOUT	Le paramètre hmxobj est l’identificateur d’un périphérique de sortie audio de forme d’onde dans la plage de zéro à un nombre inférieur au nombre d’appareils retournés par la fonction waveOutGetNumDevs.

Valeur de retour

Retourne MMSYSERR_NOERROR en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Retourner le code	Description
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 mélangeur n’est disponible pour l’objet spécifié par hmxobj.

Remarques

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	mmeapi.h (include Windows.h)
bibliothèque	Winmm.lib
DLL	Winmm.dll

Voir aussi

fonctions de mixage audio

mixeurs audio