Structure MIXERLINEW (mmeapi.h)
La structure MIXERLINE décrit l’état et les métriques d’une ligne audio.
Syntaxe
typedef struct tagMIXERLINEW {
DWORD cbStruct;
DWORD dwDestination;
DWORD dwSource;
DWORD dwLineID;
DWORD fdwLine;
DWORD_PTR dwUser;
DWORD dwComponentType;
DWORD cChannels;
DWORD cConnections;
DWORD cControls;
WCHAR szShortName[MIXER_SHORT_NAME_CHARS];
WCHAR szName[MIXER_LONG_NAME_CHARS];
struct {
DWORD dwType;
DWORD dwDeviceID;
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
WCHAR szPname[MAXPNAMELEN];
} Target;
} MIXERLINEW, *PMIXERLINEW, *LPMIXERLINEW;
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 les
dwSource
Index de la ligne source audio associée au membre dwDestination. Autrement dit, ce membre spécifie le nième ligne 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 passe de zéro à un de moins que 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 mixer 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 de mélangeur et peut être dans n’importe quel format. Une application doit utiliser cet identificateur uniquement comme handle abstrait.
fdwLine
Indicateurs d’état et de support pour la ligne audio. Ce membre est toujours retourné à l’application et ne nécessite aucune initialisation.
Si une application n’utilise pas d’appareil de sortie audio waveform-audio, la ligne audio associée à cet appareil n’est pas active (autrement dit, l’indicateur MIXERLINE_LINEF_ACTIVE n’est pas défini).
Si l’appareil de sortie audio de forme d’onde est ouvert, la ligne audio est considérée comme active et l’indicateur de MIXERLINE_LINEF_ACTIVE sera défini.
Un appareil de sortie audio de forme d’onde suspendu ou affamé est toujours considéré comme actif. En d’autres termes, si l’appareil de sortie audio waveform-audio 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 mixeur définit toujours l’indicateur de MIXERLINE_LINEF_ACTIVE.
dwUser
Données d’instance définies par l’appareil 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 qui peuvent ê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 gauche ; 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 y sont associées. Ce membre est toujours égal à zéro pour les lignes sources et pour les lignes de destination qui n’ont pas de lignes sources audio associées.
cControls
Nombre de contrôles associés à la ligne audio. Cette valeur peut être égale à 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 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 de la ligne.
Target
Informations multimédias cibles.
Target.dwType
Type d’appareil multimédia cible associé à la ligne audio décrite dans la structure MIXERLINE. Une application doit ignorer les informations cibles pour les types d’appareils 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 membre 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 membre 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 membre 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 membres de la structure |
|
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 de la structure MIXERLINE. |
|
La ligne audio décrite par 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 de l’appareil 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 à l'wMid membre de la structure des fonctionnalités d’appareil pour le support associé. Les identificateurs de fabricant sont définis dans Fabricant et Identificateurs 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 à l'wPid membre de la structure des fonctionnalités d’appareil pour le support associé. Les identificateurs de produit sont définis dans Fabricant et Identificateurs de produit.
Target.vDriverVersion
Version du pilote de l’appareil multimédia cible lorsque le membre dwType
Target.szPname[MAXPNAMELEN]
Nom du produit de l’appareil multimédia cible lorsque le membre dwType est un type cible autre que MIXERLINE_TARGETTYPE_UNDEFINED. Ce nom est identique au szPname membre de la structure des fonctionnalités d’appareil pour le média associé.
Remarques
Note
L’en-tête mmeapi.h définit MIXERLINE 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] |
| d’en-tête | mmeapi.h |
Voir aussi
Mixeurs audio