mixerGetLineInfoA, fonction (mmeapi.h)
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 |
---|---|
|
La référence de ligne audio 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 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 |