Struttura MIXERCONTROL (mmeapi.h)

La struttura MIXERCONTROL descrive lo stato e le metriche di un singolo controllo per una linea audio.

Sintassi

typedef struct tMIXERCONTROL {
  DWORD cbStruct;
  DWORD dwControlID;
  DWORD dwControlType;
  DWORD fdwControl;
  DWORD cMultipleItems;
  char  szShortName[MIXER_SHORT_NAME_CHARS];
  char  szName[MIXER_LONG_NAME_CHARS];
  union {
    struct {
      LONG lMinimum;
      LONG lMaximum;
    } DUMMYSTRUCTNAME;
    struct {
      DWORD dwMinimum;
      DWORD dwMaximum;
    } DUMMYSTRUCTNAME2;
    DWORD dwReserved[6];
  } Bounds;
  union {
    DWORD cSteps;
    DWORD cbCustomData;
    DWORD dwReserved[6];
  } Metrics;
} MIXERCONTROL, *PMIXERCONTROL, *LPMIXERCONTROL;

Members

cbStruct

Dimensioni, in byte, della struttura MIXERCONTROL .

dwControlID

Identificatore definito dal mixer audio che fa riferimento in modo univoco al controllo descritto dalla struttura MIXERCONTROL . Questo identificatore può essere in qualsiasi formato supportato dal dispositivo mixer. Un'applicazione deve usare questo identificatore solo come handle astratto. Nessun controllo per un singolo dispositivo mixer può avere lo stesso identificatore di controllo.

dwControlType

Classe del controllo per cui viene specificato l'identificatore in dwControlID. Un'applicazione deve usare queste informazioni per visualizzare il controllo appropriato per l'input dell'utente. Un'applicazione può anche visualizzare grafica personalizzata in base alla classe di controllo o alla ricerca di una determinata classe di controllo su una linea specifica. Se un'applicazione non conosce una classe di controllo, questo controllo deve essere ignorato. Sono disponibili otto classificazioni di classi di controllo, ognuna con uno o più tipi di controllo standard:

fdwControl

Flag di stato e supporto per il controllo linea audio. Vengono definiti i valori seguenti:

cMultipleItems

Numero di elementi per canale che costituiscono un controllo MIXERCONTROL_CONTROLF_MULTIPLE. Questo numero è sempre due o superiore per i controlli a più elementi. Se il controllo non è un controllo a più elementi, non utilizzare questo membro; sarà zero.

szShortName[MIXER_SHORT_NAME_CHARS]

Stringa breve che descrive il controllo linea audio specificato da dwControlID. Questa descrizione deve essere appropriata per l'uso come etichetta concisa per il controllo.

szName[MIXER_LONG_NAME_CHARS]

Stringa che descrive il controllo linea audio specificato da dwControlID. Questa descrizione deve essere appropriata per l'uso come descrizione completa per il controllo.

Bounds

Unione dei tipi di limite.

Bounds.DUMMYSTRUCTNAME

Bounds.DUMMYSTRUCTNAME.lMinimum

Valore con segno minimo per un controllo con natura limite firmato. Questo membro non può essere utilizzato insieme a dwMinimum.

Bounds.DUMMYSTRUCTNAME.lMaximum

Valore massimo con segno per un controllo con natura limite firmato. Questo membro non può essere utilizzato insieme a dwMaximum.

Bounds.DUMMYSTRUCTNAME2

Bounds.DUMMYSTRUCTNAME2.dwMinimum

Valore minimo senza segno per un controllo con natura limite senza segno. Questo membro non può essere utilizzato insieme a lMinimum.

Bounds.DUMMYSTRUCTNAME2.dwMaximum

Valore massimo senza segno per un controllo con natura limite senza segno. Questo membro non può essere utilizzato insieme a lMaximum.

Bounds.dwReserved[6]

Riservati; non usare.

Metrics

Unione delle metriche limite.

Metrics.cSteps

Numero di intervalli discreti all'interno dell'unione specificata per un controllo specificato dal membro Bounds . Questo membro si sovrappone agli altri membri del membro della struttura Metrics e non può essere usato insieme a tali membri.

Metrics.cbCustomData

Dimensioni, in byte, necessarie per contenere lo stato di una classe di controllo personalizzata. Questo membro è appropriato solo per la classe di controllo MIXERCONTROL_CONTROLTYPE_CUSTOM.

Metrics.dwReserved[6]

Riservati; non usare.

Requisiti

Vedi anche

Strutture mixer audio

Mixer audio

MIXERLINECONTROLS

mixerGetLineControls