Structure MIXERLINECONTROLS (mmeapi.h)

Article
03/08/2023

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

Syntaxe

typedef struct tMIXERLINECONTROLS {
  DWORD          cbStruct;
  DWORD          dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  };
  DWORD          cControls;
  DWORD          cbmxctrl;
  LPMIXERCONTROL pamxctrl;
} MIXERLINECONTROLS, *PMIXERLINECONTROLS, *LPMIXERLINECONTROLS;

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

dwControlID

Identificateur de contrôle du contrôle souhaité. Ce membre est utilisé avec l’indicateur MIXER_GETLINECONTROLSF_ONEBYID pour la fonction mixerGetLineControls afin de récupérer les informations de contrôle du contrôle spécifié. Notez que le membre dwLineID de la structure MIXERLINECONTROLS est retourné par le périphérique de mélangeur et n’est pas requis 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.

dwControlType

Classe des types de contrôle souhaités. Ce membre est utilisé avec l’indicateur MIXER_GETLINECONTROLSF_ONEBYTYPE pour la fonction mixerGetLineControls afin de récupérer le premier contrôle de la classe spécifiée sur la ligne spécifiée par le membre dwLineID 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 avoir la valeur 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 est 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é.

cbmxctrl

Taille, en octets, d’une seule structure MIXERCONTROL . La taille spécifiée dans ce membre doit être au moins suffisamment grande pour contenir la structure MIXERCONTROL de base. La taille totale, en octets, requise pour la mémoire tampon vers laquelle pointe le membre pamxctrl est le produit des membres cbmxctrl et cControls 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 suffisamment grand pour contenir une structure MIXERCONTROL de base. Le membre cbmxctrl 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 membre cbStruct de chaque structure MIXERCONTROL ) lors du retour.

Spécifications


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