MIXERCONTROLA-Struktur (mmeapi.h)

Die MIXERCONTROL-Struktur beschreibt den Zustand und die Metriken eines einzelnen Steuerelements für eine Audioleitung.

Syntax

typedef struct tagMIXERCONTROLA {
  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;
} MIXERCONTROLA, *PMIXERCONTROLA, *LPMIXERCONTROLA;

Members

cbStruct

Größe der MIXERCONTROL-Struktur in Bytes.

dwControlID

Audiomischer-definierter Bezeichner, der eindeutig auf das steuerelement verweist, das von der MIXERCONTROL-Struktur beschrieben wird. Dieser Bezeichner kann in einem beliebigen Format vorliegen, das vom Mixergerät unterstützt wird. Eine Anwendung sollte diesen Bezeichner nur als abstraktes Handle verwenden. Keine zwei Steuerelemente für ein einzelnes Mixergerät können denselben Steuerelementbezeichner aufweisen.

dwControlType

Klasse des Steuerelements, für das der Bezeichner in dwControlID angegeben ist. Eine Anwendung muss diese Informationen verwenden, um das entsprechende Steuerelement für die Eingabe vom Benutzer anzuzeigen. Eine Anwendung kann auch maßgeschneiderte Grafiken basierend auf der Steuerelementklasse anzeigen oder nach einer bestimmten Steuerelementklasse in einer bestimmten Zeile suchen. Wenn eine Anwendung keine Kenntnis von einer Steuerelementklasse hat, muss dieses Steuerelement ignoriert werden. Es gibt acht Steuerelementklassenklassifizierungen mit jeweils einem oder mehreren Standardsteuerelementtypen:

Name Beschreibungen
MIXERCONTROL_CT_CLASS_CUSTOM
MIXERCONTROL_CONTROLTYPE_CUSTOM
MIXERCONTROL_CT_CLASS_FADER
MIXERCONTROL_CONTROLTYPE_BASS MIXERCONTROL_CONTROLTYPE_EQUALIZER MIXERCONTROL_CONTROLTYPE_FADER MIXERCONTROL_CONTROLTYPE_TREBLE MIXERCONTROL_CONTROLTYPE_VOLUME
MIXERCONTROL_CT_CLASS_LIST
MIXERCONTROL_CONTROLTYPE_MIXER MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT MIXERCONTROL_CONTROLTYPE_MUX MIXERCONTROL_CONTROLTYPE_SINGLESELECT
MIXERCONTROL_CT_CLASS_METER
MIXERCONTROL_CONTROLTYPE_BOOLEANMETER MIXERCONTROL_CONTROLTYPE_PEAKMETER MIXERCONTROL_CONTROLTYPE_SIGNEDMETER MIXERCONTROL_CONTROLTYPE_UNSIGNEDMETER
MIXERCONTROL_CT_CLASS_NUMBER
MIXERCONTROL_CONTROLTYPE_DECIBELS MIXERCONTROL_CONTROLTYPE_PERCENT MIXERCONTROL_CONTROLTYPE_SIGNED MIXERCONTROL_CONTROLTYPE_UNSIGNED
MIXERCONTROL_CT_CLASS_SLIDER
MIXERCONTROL_CONTROLTYPE_PAN MIXERCONTROL_CONTROLTYPE_QSOUNDPAN MIXERCONTROL_CONTROLTYPE_SLIDER
MIXERCONTROL_CT_CLASS_SWITCH
MIXERCONTROL_CONTROLTYPE_BOOLEAN MIXERCONTROL_CONTROLTYPE_BUTTON MIXERCONTROL_CONTROLTYPE_LOUDNESS MIXERCONTROL_CONTROLTYPE_MONO MIXERCONTROL_CONTROLTYPE_MUTE MIXERCONTROL_CONTROLTYPE_ONOFF MIXERCONTROL_CONTROLTYPE_STEREOENH
MIXERCONTROL_CT_CLASS_TIME
MIXERCONTROL_CONTROLTYPE_MICROTIME MIXERCONTROL_CONTROLTYPE_MILLITIME

fdwControl

Status- und Supportflags für das Audioliniensteuerelement. Die folgenden Werte werden definiert:

Name BESCHREIBUNG
MIXERCONTROL_CONTROLF_DISABLED
Das Steuerelement ist deaktiviert, möglicherweise aufgrund anderer Einstellungen für die Mixerhardware, und kann nicht verwendet werden. Eine Anwendung kann aktuelle Einstellungen aus einem deaktivierten Steuerelement lesen, aber keine Einstellungen anwenden.
MIXERCONTROL_CONTROLF_MULTIPLE
Das Steuerelement verfügt über mindestens zwei Einstellungen pro Kanal. Ein Equalizer erfordert z. B. dieses Flag, da jedes Frequenzband auf einen anderen Wert festgelegt werden kann. Ein Equalizer, der sich auf beide Kanäle einer Stereolinie in einheitlicher Weise auswirkt, gibt auch das MIXERCONTROL_CONTROLF_UNIFORM-Flag an.
MIXERCONTROL_CONTROLF_UNIFORM
Das Steuerelement wirkt auf alle Kanäle einer Mehrkanallinie einheitlich. Beispielsweise würde ein Steuerelement, das beide Kanäle einer Stereolinie stummschaltet, dieses Flag festlegen. Die meisten MIXERCONTROL_CONTROLTYPE_MUX- und MIXERCONTROL_CONTROLTYPE_MIXER-Steuerelemente geben auch das MIXERCONTROL_CONTROLF_UNIFORM-Flag an.

cMultipleItems

Die Anzahl der Elemente pro Kanal, aus denen ein MIXERCONTROL_CONTROLF_MULTIPLE-Steuerelement besteht. Diese Zahl ist bei Steuerelementen mit mehreren Elementen immer zwei oder mehr. Wenn es sich bei dem Steuerelement nicht um ein Steuerelement mit mehreren Elementen handelt, verwenden Sie dieses Element nicht. es wird null sein.

szShortName[MIXER_SHORT_NAME_CHARS]

Kurze Zeichenfolge, die das von dwControlID angegebene Audioliniensteuerelement beschreibt. Diese Beschreibung sollte als prägnante Bezeichnung für das Steuerelement verwendet werden.

szName[MIXER_LONG_NAME_CHARS]

Zeichenfolge, die das von dwControlID angegebene Audiozeilensteuerelement beschreibt. Diese Beschreibung sollte als vollständige Beschreibung für das Steuerelement verwendet werden.

Bounds

Union von Begrenzungstypen.

Bounds.DUMMYSTRUCTNAME

Bounds.DUMMYSTRUCTNAME.lMinimum

Minimaler Vorzeichenwert für ein Steuerelement mit vorzeichenierter Begrenzungsart. Dieses Element kann nicht in Verbindung mit dwMinimum verwendet werden.

Bounds.DUMMYSTRUCTNAME.lMaximum

Maximaler Vorzeichenwert für ein Steuerelement mit vorzeichenierter Begrenzungsart. Dieses Element kann nicht in Verbindung mit dwMaximum verwendet werden.

Bounds.DUMMYSTRUCTNAME2

Bounds.DUMMYSTRUCTNAME2.dwMinimum

Minimaler Wert ohne Vorzeichen für ein Steuerelement, das über eine nicht signierte Begrenzung verfügt. Dieses Element kann nicht in Verbindung mit lMinimum verwendet werden.

Bounds.DUMMYSTRUCTNAME2.dwMaximum

Maximaler Wert ohne Vorzeichen für ein Steuerelement, das über eine nicht signierte Begrenzungsnatur verfügt. Dieses Element kann nicht in Verbindung mit lMaximum verwendet werden.

Bounds.dwReserved[6]

Reserviert; nicht verwenden.

Metrics

Union von Begrenzungsmetriken.

Metrics.cSteps

Anzahl diskreter Bereiche innerhalb der Union, die für ein vom Bounds-Element angegebenes Steuerelement angegeben ist. Dieses Element überschneidet sich mit den anderen Membern des Metrikstrukturelements und kann nicht in Verbindung mit diesen Elementen verwendet werden.

Metrics.cbCustomData

Größe in Bytes, die erforderlich ist, um den Zustand einer benutzerdefinierten Steuerelementklasse zu enthalten. Dieser Member ist nur für die MIXERCONTROL_CONTROLTYPE_CUSTOM-Steuerelementklasse geeignet.

Metrics.dwReserved[6]

Reserviert; nicht verwenden.

Hinweise

Hinweis

Der mmeapi.h-Header definiert MIXERCONTROL als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile mmeapi.h

Weitere Informationen

Audiomischerstrukturen

Audiomischer

MIXERLINECONTROLS

mixerGetLineControls