Struttura MIXERCONTROLW (mmeapi.h)

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

Sintassi

typedef struct tagMIXERCONTROLW {
  DWORD cbStruct;
  DWORD dwControlID;
  DWORD dwControlType;
  DWORD fdwControl;
  DWORD cMultipleItems;
  WCHAR szShortName[MIXER_SHORT_NAME_CHARS];
  WCHAR 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;
} MIXERCONTROLW, *PMIXERCONTROLW, *LPMIXERCONTROLW;

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ò mai 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 cercare una determinata classe di controllo in una riga specifica. Se un'applicazione non conosce una classe di controllo, questo controllo deve essere ignorato. Sono disponibili otto classificazioni della classe di controllo, ognuna con uno o più tipi di controllo standard:

fdwControl

Stato e flag di supporto per il controllo linea audio. I valori seguenti sono definiti:

cMultipleItems

Numero di elementi per canale che costituiscono un controllo MIXERCONTROL_CONTROLF_MULTIPLE. Questo numero è sempre due o maggiore per i controlli a più elementi. Se il controllo non è un controllo a più elementi, non usare 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 minimo firmato per un controllo con natura di limite firmato. Questo membro non può essere usato in combinazione con dwMinimum.

Bounds.DUMMYSTRUCTNAME.lMaximum

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

Bounds.DUMMYSTRUCTNAME2

Bounds.DUMMYSTRUCTNAME2.dwMinimum

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

Bounds.DUMMYSTRUCTNAME2.dwMaximum

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

Bounds.dwReserved[6]

Riservati; non usare.

Metrics

Unione delle metriche di 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 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.

Commenti

Requisiti

Vedi anche

Strutture del mixer audio

Mixer audio

MIXERLINECONTROLS

mixerGetLineControls