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:
fdwControl
Status- und Supportflags für das Audioliniensteuerelement. Die folgenden Werte werden definiert:
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
Audiomischer