Structure MIXERLINE (mmeapi.h)

Article
08/24/2023

La structure MIXERLINE décrit l’état et les métriques d’une ligne audio.

Syntaxe

typedef struct tMIXERLINE {
  DWORD  cbStruct;
  DWORD  dwDestination;
  DWORD  dwSource;
  DWORD  dwLineID;
  DWORD  fdwLine;
  DWORD  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;
    VERSION vDriverVersion;
    char    szPname[MAXPNAMELEN];
  } Target;
} MIXERLINE, *PMIXERLINE, *LPMIXERLINE;

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épasseront pas la taille demandée.

dwDestination

Index de ligne de destination. Ce membre est inférieur de zéro à un de 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’elle est appelée 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 est 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 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 pour la ligne audio. Ce membre est toujours retourné à l’application et ne nécessite aucune initialisation.

Nom	Description
MIXERLINE_LINEF_ACTIVE	La ligne audio est active. Une ligne active indique qu’un signal passe probablement par la ligne.
MIXERLINE_LINEF_DISCONNECTED	La ligne audio est déconnectée. Les contrôles associés d’une ligne déconnectée peuvent toujours être modifiés, mais les modifications n’ont aucun effet tant que la ligne n’est pas connectée.
MIXERLINE_LINEF_SOURCE	La ligne audio est une ligne source audio associée à une seule ligne de destination audio. Si cet indicateur n’est pas défini, cette ligne est une ligne de destination audio associée à zéro ou plusieurs lignes sources audio.

Si une application n’utilise pas un 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 périphérique de sortie audio de forme d’onde suspendu 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 mélangeur 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 retournant 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 pour rechercher un composant particulier. Si une application n’utilise pas de types de composants, ce membre doit être ignoré. Ce membre peut avoir l’une des valeurs suivantes :

Nom	Description
MIXERLINE_COMPONENTTYPE_DST_DIGITAL	La ligne audio est une destination numérique (par exemple, une entrée numérique sur un périphérique audio DAT ou CD).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	La ligne audio est une destination réglable (gain et/ou atténuation) destinée à conduire un casque. La plupart des cartes audio utilisent la même ligne de destination audio pour les haut-parleurs et les casques, auquel cas l’appareil de mixage utilise simplement le type MIXERLINE_COMPONENTTYPE_DST_SPEAKERS.
MIXERLINE_COMPONENTTYPE_DST_LINE	La ligne audio est une destination au niveau de la ligne (par exemple, une entrée au niveau de la ligne à partir d’un périphérique audio CD) qui sera la source d’enregistrement finale pour le convertisseur analogique-numérique (ADC). Étant donné que la plupart des cartes audio pour ordinateurs personnels fournissent une sorte de gain pour la ligne source audio d’enregistrement, l’appareil de mixage utilise le type de MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_MONITOR	La ligne audio est une destination utilisée pour un moniteur.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	La ligne audio est une destination réglable (gain et/ou atténuation) destinée à piloter des haut-parleurs. Il s’agit du type de composant standard pour la sortie audio des cartes audio pour les ordinateurs personnels.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE	La ligne audio est une destination qui sera acheminée vers une ligne téléphonique.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED	La ligne audio est une destination qui ne peut pas être définie par l’un des types de composants standard. Un appareil mixer est nécessaire pour utiliser ce type de composant pour les types de composants de ligne qui n’ont pas été définis par Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	La ligne audio est une destination qui sera la source d’enregistrement finale pour l’entrée vocale. Ce type de composant est exactement comme MIXERLINE_COMPONENTTYPE_DST_WAVEIN, mais est spécifiquement destiné aux paramètres utilisés lors de l’enregistrement/de la reconnaissance vocale. La prise en charge de cette ligne est facultative pour un appareil mixer. De nombreux appareils de mélangeur fournissent uniquement des MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN	La ligne audio est une destination qui sera la source d’enregistrement finale pour l’entrée audio de forme d’onde (ADC). Cette ligne fournit généralement une sorte de gain ou d’atténuation. Il s’agit du type de composant standard pour la ligne d’enregistrement de la plupart des cartes audio pour ordinateurs personnels.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG	La ligne audio est une source analogique (par exemple, sortie analogique à partir d’une cassette vidéo).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY	La ligne audio est une source provenant de la ligne audio auxiliaire. Ce type de ligne est conçu comme une source avec gain ou atténuation qui peut être routée vers la destination MIXERLINE_COMPONENTTYPE_DST_SPEAKERS et/ou enregistrée à partir de la destination MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC	La ligne audio est une source provenant de la sortie d’un CD audio interne. Ce type de composant est fourni pour les cartes audio qui fournissent une ligne de source audio destinée à être connectée à un CD audio (ou CD-ROM qui lit un CD audio).
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL	La ligne audio est une source numérique (par exemple, sortie numérique d’un DAT ou d’un CD audio).
MIXERLINE_COMPONENTTYPE_SRC_LINE	La ligne audio est une source au niveau de la ligne (par exemple, une entrée au niveau de la ligne à partir d’une chaîne stéréo externe) qui peut être utilisée comme source d’enregistrement facultative. Étant donné que la plupart des cartes audio pour ordinateurs personnels fournissent une sorte de gain pour la ligne source d’enregistrement, l’appareil de mixage utilise le type MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	La ligne audio est une source d’enregistrement de microphone. La plupart des cartes audio pour ordinateurs personnels fournissent au moins deux types de sources d’enregistrement : une ligne audio auxiliaire et une entrée microphone. Une ligne audio de microphone offre généralement une sorte de gain. Les cartes audio qui utilisent une seule entrée à utiliser avec un microphone ou une ligne audio auxiliaire doivent utiliser le type de composant MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER	La ligne audio est une source provenant du haut-parleur de l’ordinateur personnel. Plusieurs cartes audio pour ordinateurs personnels offrent la possibilité de mélanger ce qui serait généralement lu sur le haut-parleur interne avec la sortie d’un carte audio. Certaines cartes audio prennent en charge la possibilité d’utiliser cette sortie comme source d’enregistrement.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER	La ligne audio est une source provenant de la sortie d’un synthétiseur interne. La plupart des cartes audio pour ordinateurs personnels fournissent une sorte de synthétiseur MIDI.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE	La ligne audio est une source provenant d’une ligne téléphonique entrante.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED	La ligne audio est une source qui ne peut pas être définie par l’un des types de composants standard. Un appareil mixer est nécessaire pour utiliser ce type de composant pour les types de composants de ligne qui n’ont pas été définis par Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	La ligne audio est une source provenant du convertisseur numérique-analogique (DAC) de sortie audio de forme d’onde. La plupart des cartes audio des ordinateurs personnels fournissent ce type de composant comme source de la destination MIXERLINE_COMPONENTTYPE_DST_SPEAKERS. Certaines cartes permettent également d’acheminer cette source vers la destination MIXERLINE_COMPONENTTYPE_DST_WAVEIN.

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
MIXERLINE_TARGETTYPE_AUX	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 .
MIXERLINE_TARGETTYPE_MIDIIN	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 .
MIXERLINE_TARGETTYPE_MIDIOUT	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 .
MIXERLINE_TARGETTYPE_UNDEFINED	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.
MIXERLINE_TARGETTYPE_WAVEIN	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 .
MIXERLINE_TARGETTYPE_WAVEOUT	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é.

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

Structures de mixage audio

Mixeurs audio

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo