Structure MIXERLINEA (mmeapi.h)
La structure MIXERLINE décrit l’état et les métriques d’une ligne audio.
Syntaxe
typedef struct tagMIXERLINEA {
DWORD cbStruct;
DWORD dwDestination;
DWORD dwSource;
DWORD dwLineID;
DWORD fdwLine;
DWORD_PTR dwUser;
DWORD dwComponentType;
DWORD cChannels;
DWORD cConnections;
DWORD cControls;
CHAR szShortName[MIXER_SHORT_NAME_CHARS];
CHAR szName[MIXER_LONG_NAME_CHARS];
struct {
DWORD dwType;
DWORD dwDeviceID;
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
CHAR szPname[MAXPNAMELEN];
} Target;
} MIXERLINEA, *PMIXERLINEA, *LPMIXERLINEA;
Membres
cbStruct
Taille, en octets, de la structure MIXERLINE . Ce membre doit être initialisé avant d’appeler la fonction mixerGetLineInfo . La taille spécifiée dans ce membre doit être suffisamment grande pour contenir la structure MIXERLINE . Lorsque mixerGetLineInfo retourne, ce membre contient la taille réelle des informations retournées. Les informations retournées ne dépassent pas la taille demandée.
dwDestination
Index de ligne de destination. Ce membre varie de zéro à un inférieur à la valeur spécifiée dans le membre cDestinations de la structure MIXERCAPS récupérée par la fonction mixerGetDevCaps . Lorsque la fonction mixerGetLineInfo est appelée avec l’indicateur MIXER_GETLINEINFOF_DESTINATION, les propriétés de la ligne de destination sont retournées. (Le membre dwSource doit être défini sur zéro dans ce cas.) Lorsqu’il est appelé avec l’indicateur MIXER_GETLINEINFOF_SOURCE, les propriétés de la source donnée par le membre dwSource associé au membre dwDestination sont retournées.
dwSource
Index de la ligne source audio associée au membre dwDestination . Autrement dit, ce membre spécifie la nièmeligne source audio associée à la ligne de destination audio spécifiée. Ce membre n’est pas utilisé pour les lignes de destination et doit être défini sur zéro lorsque MIXER_GETLINEINFOF_DESTINATION est spécifié dans la fonction mixerGetLineInfo . Lorsque l’indicateur MIXER_GETLINEINFOF_SOURCE est spécifié, ce membre varie de zéro à un inférieur à la valeur spécifiée dans le membre cConnections pour la ligne de destination audio donnée dans le membre dwDestination .
dwLineID
Identificateur défini par l’appareil de mixage qui fait référence de manière unique à la ligne audio décrite par la structure MIXERLINE . Cet identificateur est unique pour chaque appareil mixer et peut être dans n’importe quel format. Une application doit utiliser cet identificateur uniquement comme handle abstrait.
fdwLine
Indicateurs d’état et de prise en charge de la ligne audio. Ce membre est toujours retourné à l’application et ne nécessite aucune initialisation.
Si une application n’utilise pas de périphérique de sortie audio de forme d’onde, la ligne audio associée à cet appareil n’est pas active (autrement dit, l’indicateur MIXERLINE_LINEF_ACTIVE n’est pas défini).
Si le périphérique de sortie audio de forme d’onde est ouvert, la ligne audio est considérée comme active et l’indicateur MIXERLINE_LINEF_ACTIVE est défini.
Un appareil de sortie audio de forme d’onde en pause ou affamé est toujours considéré comme actif. En d’autres termes, si le périphérique de sortie audio de forme d’onde est ouvert par une application, que les données soient lues ou non, la ligne audio associée est considérée comme active.
Si une ligne ne peut pas être strictement définie comme étant active, l’appareil de mixage définit toujours l’indicateur MIXERLINE_LINEF_ACTIVE.
dwUser
Données d’instance définies par le périphérique audio pour la ligne. Ce membre est destiné aux applications de mixage personnalisées conçues spécifiquement pour l’appareil de mélangeur qui retourne ces informations. Les autres applications doivent ignorer ces données.
dwComponentType
Type de composant pour cette ligne audio. Une application peut utiliser ces informations pour afficher des graphiques personnalisés ou rechercher un composant particulier. Si une application n’utilise pas de types de composants, ce membre doit être ignoré. Ce membre peut être l’une des valeurs suivantes :
cChannels
Nombre maximal de canaux distincts pouvant être manipulés indépendamment pour la ligne audio. La valeur minimale de ce champ est 1, car une ligne doit avoir au moins un canal.
La plupart des cartes audio modernes pour les ordinateurs personnels sont des appareils stéréo ; pour eux, la valeur de ce membre est 2.
Le canal 1 est supposé être le canal de gauche ; Le canal 2 est supposé être le canal approprié.
Une ligne multicanal peut avoir un ou plusieurs contrôles uniformes (contrôles qui affectent tous les canaux d’une ligne uniformément) associés.
cConnections
Nombre de connexions associées à la ligne audio. Ce membre est utilisé uniquement pour les lignes de destination audio et spécifie le nombre de lignes sources audio qui lui sont associées. Ce membre est toujours égal à zéro pour les lignes sources et pour les lignes de destination qui n’ont aucune ligne source audio associée.
cControls
Nombre de contrôles associés à la ligne audio. Cette valeur peut être zéro. Si aucun contrôle n’est associé à la ligne, la ligne est susceptible d’être une source qui peut être sélectionnée dans un MIXERCONTROL_CONTROLTYPE_MUX ou un MIXERCONTROL_CONTROLTYPE_MIXER, mais n’autorise aucune manipulation du signal.
szShortName[MIXER_SHORT_NAME_CHARS]
Chaîne courte qui décrit la ligne de mixage audio spécifiée dans le membre dwLineID . Cette description doit être appropriée en tant qu’étiquette concise pour la ligne.
szName[MIXER_LONG_NAME_CHARS]
Chaîne qui décrit la ligne de mixage audio spécifiée dans le membre dwLineID . Cette description doit être appropriée en tant que description complète pour la ligne.
Target
Informations sur le média cible.
Target.dwType
Type de périphérique multimédia cible associé à la ligne audio décrite dans la structure MIXERLINE . Une application doit ignorer les informations cibles pour les types de périphériques multimédias qu’elle n’utilise pas. Les valeurs suivantes sont définies :
| Nom | Description |
|---|---|
|
La ligne audio décrite par la structure MIXERLINE est strictement liée à l’appareil auxiliaire détaillé dans les membres restants de la structure Target de la structure MIXERLINE . |
|
La ligne audio décrite par la structure MIXERLINE est strictement liée au périphérique d’entrée MIDI détaillé dans les membres restants de la structure Target de la structure MIXERLINE . |
|
La ligne audio décrite par la structure MIXERLINE est strictement liée au périphérique de sortie MIDI détaillé dans les membres restants de la structure Target de la structure MIXERLINE . |
|
La ligne audio décrite par la structure MIXERLINE n’est pas strictement liée à un type de média défini. Tous les autres membres de la structure Target de la structure MIXERLINE doivent être ignorés. Une application ne peut pas utiliser le type de cible MIXERLINE_TARGETTYPE_UNDEFINED lors de l’appel de la fonction mixerGetLineInfo avec l’indicateur MIXER_GETLINEINFOF_TARGETTYPE. |
|
La ligne audio décrite par la structure MIXERLINE est strictement liée au périphérique d’entrée audio de forme d’onde détaillé dans les membres restants de la structure Target membre de la structure MIXERLINE . |
|
La ligne audio décrite par la structure MIXERLINE est strictement liée au périphérique de sortie audio de forme d’onde détaillé dans les membres restants de la structure Target membre de la structure MIXERLINE . |
Target.dwDeviceID
Identificateur d’appareil actuel de l’appareil multimédia cible lorsque le membre dwType est un type cible autre que MIXERLINE_TARGETTYPE_UNDEFINED. Cet identificateur est identique à l’index actuel du périphérique multimédia associé. Lors de l’appel de la fonction mixerGetLineInfo avec l’indicateur MIXER_GETLINEINFOF_TARGETTYPE, ce membre est ignoré lors de l’entrée et est retourné à l’appelant par le gestionnaire de mixage audio.
Target.wMid
Identificateur du fabricant de l’appareil multimédia cible lorsque le membre dwType est un type cible autre que MIXERLINE_TARGETTYPE_UNDEFINED. Cet identificateur est identique au membre wMid de la structure device-capabilities pour le média associé. Les identificateurs de fabricant sont définis dans Identificateurs de fabricant et de produit.
Target.wPid
Identificateur de produit de l’appareil multimédia cible lorsque le membre dwType est un type cible autre que MIXERLINE_TARGETTYPE_UNDEFINED. Cet identificateur est identique au membre wPid de la structure device-capabilities pour le média associé. Les identificateurs de produit sont définis dans Identificateurs de fabricant et de produit.
Target.vDriverVersion
Version du pilote du périphérique multimédia cible lorsque le membre dwType est un type cible autre que MIXERLINE_TARGETTYPE_UNDEFINED. Cette version est identique au membre vDriverVersion de la structure device-capabilities pour le média associé.
Target.szPname[MAXPNAMELEN]
Nom de produit de l’appareil multimédia cible lorsque le membre dwType est un type de cible autre que MIXERLINE_TARGETTYPE_UNDEFINED. Ce nom est identique au membre szPname de la structure device-capabilities pour le média associé.
Remarques
Notes
L’en-tête mmeapi.h définit MIXERLINE 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.
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] |
| En-tête | mmeapi.h |
Voir aussi
Mixeurs audio