fonction mixerGetLineInfo (mmeapi.h)
La fonction mixerGetLineInfo récupère des informations sur une ligne spécifique d’un appareil de mixage.
Syntaxe
MMRESULT mixerGetLineInfo(
HMIXEROBJ hmxobj,
LPMIXERLINE 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 est utilisé pour 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 inférieur à la valeur du 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 inférieur à la valeur dans le membre cDestinations de la structure MIXERCAPS . L’index spécifié par dwSource varie de zéro à un inférieur à 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 correspondant au membre dwType de la structure Cible , 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 de l’appareil pour tous les appareils 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 la perte de données.
|
| 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 un identificateur d’appareil de mélangeur compris entre zéro et un 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 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 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 appareil de mixage n’est disponible pour l’objet spécifié par hmxobj. |
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 |