Structure MIXERLINECONTROLSA (mmeapi.h)

Article
11/20/2024

La structure MIXERLINECONTROLS contient des informations sur les contrôles d’une ligne audio.

Syntaxe

typedef struct tagMIXERLINECONTROLSA {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;

Membres

cbStruct

Taille, en octets, de la structure MIXERLINECONTROLS. Ce membre doit être initialisé avant d’appeler la fonction mixerGetLineControls . La taille spécifiée dans ce membre doit être suffisamment grande pour contenir la structure MIXERLINECONTROLS. Lorsque mixerGetLineControls retourne, ce membre contient la taille réelle des informations retournées. Les informations retournées ne dépassent pas la taille demandée, et elles ne sont pas plus petites que la structure MIXERLINECONTROLS.

dwLineID

Identificateur de ligne pour lequel les contrôles sont interrogés. Ce membre n’est pas utilisé si l’indicateur MIXER_GETLINECONTROLSF_ONEBYID est spécifié pour la fonction mixerGetLineControls, mais que l’appareil de mélangeur retourne toujours ce membre dans ce cas. Les membres dwControlID et dwControlType ne sont pas utilisés lorsque MIXER_GETLINECONTROLSF_ALL est spécifié.

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

Identificateur de contrôle du contrôle souhaité. Ce membre est utilisé avec l’indicateur MIXER_GETLINECONTROLSF_ONEBYID pour la fonction mixerGetLineControls pour récupérer les informations de contrôle du contrôle spécifié. Notez que le membre dwLineID de la structure MIXERLINECONTROLS sera retourné par l’appareil de mixeur et n’est pas obligatoire en tant que paramètre d’entrée. Ce membre chevauche le membre dwControlType et ne peut pas être utilisé conjointement avec le type de requête MIXER_GETLINECONTROLSF_ONEBYTYPE.

DUMMYUNIONNAME.dwControlType

Classe des types de contrôle souhaités. Ce membre est utilisé avec l’indicateur MIXER_GETLINECONTROLSF_ONEBYTYPE pour la fonction mixerGetLineControls pour récupérer le premier contrôle de la classe spécifiée sur la ligne spécifiée par le dwLineID membre de la structure MIXERLINECONTROLS. Ce membre chevauche le membre dwControlID et ne peut pas être utilisé conjointement avec le type de requête MIXER_GETLINECONTROLSF_ONEBYID. Consultez la description du membre dwControlType dans mixerCONTROL.

cControls

Nombre d’éléments de structure MIXERCONTROL à récupérer. Ce membre doit être initialisé par l’application avant d’appeler la fonction mixerGetLineControls. Ce membre ne peut être 1 que si MIXER_GETLINECONTROLSF_ONEBYID ou MIXER_GETLINECONTROLSF_ONEBYTYPE est spécifié ou si la valeur retournée dans le membre cControls de la structure MIXERLINE retournée pour une ligne audio. Ce membre ne peut pas être égal à zéro. Si une ligne audio spécifie qu’elle n’a aucun contrôle, mixerGetLineControls ne doit pas être appelée.

cbmxctrl

Taille, en octets, d’une seule structure MIXERCONTROL. La taille spécifiée dans ce membre doit être au moins grande pour contenir la structure de base MIXERCONTROL. La taille totale, en octets, requise pour la mémoire tampon pointée par le membre pamxctrl est le produit du cbmxctrl et cControls membres de la structure MIXERLINECONTROLS.

pamxctrl

Pointeur vers une ou plusieurs structures mixerCONTROL pour recevoir les propriétés des contrôles de ligne audio demandés. Ce membre ne peut pas être NULL et doit être initialisé avant d’appeler la fonction mixerGetLineControls . Chaque élément du tableau de contrôles doit être au moins volumineux pour contenir une structure de base MIXERCONTROL. Le cbmxctrl membre doit spécifier la taille, en octets, de chaque élément de ce tableau. Aucune initialisation de la mémoire tampon pointée par ce membre n’est requise par l’application. Tous les membres sont renseignés par l’appareil de mélangeur (y compris le cbStruct membre de chaque structure MIXERCONTROL) lors du retour.

Remarques

Note

L’en-tête mmeapi.h définit MIXERLINECONTROLS 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

structures de mixage audio

mixeurs audio

mixerCONTROL

MIXERLINE

mixerGetLineControls

Partager via