mixerGetLineInfoA, fonction (mmeapi.h)

  • Article

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

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 permettant de 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 permet de récupérer des informations sur une ligne audio d’un type de composant spécifique. Les membres de structure restants à l’exception de cbStruct ne nécessitent aucune 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 le membre cDestinations de la structure MIXERCAPS . Tous les membres de structure restants, à l’exception de 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, à l’exception de 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 les membres dwDestination et dwSource de la structure MIXERLINE . L’index spécifié par dwDestination varie de zéro à un de moins que la valeur du membre cDestinations de la structure MIXERCAPS . L’index spécifié par dwSource varie de zéro à un de moins que la valeur dans le membre cConnections de la structure MIXERLINE retournée pour la ligne audio stockée dans le membre dwDestination . Tous les membres de structure restants, à l’exception de cbStruct , ne nécessitent aucune initialisation supplémentaire.
MIXER_GETLINEINFOF_TARGETTYPE Le paramètre pmxl reçoit des informations sur la ligne audio destinée au membre dwType de la structure Target , qui est membre de la structure MIXERLINE . Cet indicateur permet de récupérer des informations sur une ligne audio qui gère le type cible (par exemple, MIXERLINE_TARGETTYPE_WAVEOUT). L’application doit initialiser les membres dwType, wMid, wPid, vDriverVersion et szPname 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 périphériques multimédias. Les membres de structure restants à l’exception de cbStruct ne nécessitent aucune initialisation supplémentaire.
Note 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 de mixerGetLineInfo avec l’indicateur MIXER_GETLINEINFOF_TARGETTYPE . La raison en est qu’une conversion interne vers et à partir d’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 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. 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 un identificateur d’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_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 dispositif de mixage n’est disponible pour l’objet spécifié par hmxobj.

Notes

Notes

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

Spécifications

   
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