Structure MIXERLINECONTROLSW (mmeapi.h)

Article
08/24/2023

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

Syntaxe

typedef struct tagMIXERLINECONTROLSW {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLW pamxctrl;
} MIXERLINECONTROLSW, *PMIXERLINECONTROLSW, *LPMIXERLINECONTROLSW;

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 mixage 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 de 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 mixage 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 de 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 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 ê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 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 pointée par 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 mixage (y compris le membre cbStruct de chaque structure MIXERCONTROL ) lors du retour réussi.

Notes

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

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