MIXERCONTROLW-Struktur (mmeapi.h)
Die MIXERCONTROL Struktur beschreibt den Zustand und die Metriken eines einzelnen Steuerelements für eine Audiolinie.
Syntax
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;
Angehörige
cbStruct
Größe der MIXERCONTROL- Struktur in Byte.
dwControlID
Audiomixerdefinierter Bezeichner, der eindeutig auf das von der MIXERCONTROL Struktur beschriebene Steuerelement verweist. Dieser Bezeichner kann in jedem format sein, das vom Mixergerät unterstützt wird. Eine Anwendung sollte diesen Bezeichner nur als abstraktes Handle verwenden. Keine zwei Steuerelemente für ein einzelnes Mischgerät können je denselben Steuerelementbezeichner aufweisen.
dwControlType
Klasse des Steuerelements, für das der Bezeichner in dwControlID-angegeben wird. Eine Anwendung muss diese Informationen verwenden, um das entsprechende Steuerelement für die Eingabe des Benutzers 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 nicht über eine Steuerelementklasse weiß, muss dieses Steuerelement ignoriert werden. Es gibt acht Steuerelementklassenklassifizierungen, die jeweils einen oder mehrere Standardsteuerelementtypen enthalten:
fdwControl
Status- und Supportkennzeichnungen für das Audioleitungssteuerelement. Die folgenden Werte sind definiert:
cMultipleItems
Die Anzahl der Elemente pro Kanal, aus denen ein MIXERCONTROL_CONTROLF_MULTIPLE-Steuerelement besteht. Diese Zahl ist immer zwei oder mehr für Steuerelemente mit mehreren Elementen. 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 durch dwControlID-angegebene Audioleitungssteuerelement beschreibt. Diese Beschreibung sollte geeignet sein, um sie als prägnante Bezeichnung für das Steuerelement zu verwenden.
szName[MIXER_LONG_NAME_CHARS]
String that describes the audio line control specified by dwControlID. Diese Beschreibung sollte für die Verwendung als vollständige Beschreibung für das Steuerelement geeignet sein.
Bounds
Union von Grenztypen.
Bounds.DUMMYSTRUCTNAME
Bounds.DUMMYSTRUCTNAME.lMinimum
Minimalsignierter Wert für ein Steuerelement, das eine signierte Begrenzungsbeschaffenheit aufweist. Dieses Element kann nicht in Verbindung mit dwMinimumverwendet werden.
Bounds.DUMMYSTRUCTNAME.lMaximum
Maximaler signierter Wert für ein Steuerelement, das über eine signierte Begrenzungsbeschaffenheit verfügt. Dieses Element kann nicht in Verbindung mit dwMaximumverwendet werden.
Bounds.DUMMYSTRUCTNAME2
Bounds.DUMMYSTRUCTNAME2.dwMinimum
Minimaler nicht signierter Wert für ein Steuerelement, das eine nicht signierte Begrenzungsbeschaffenheit aufweist. Dieses Element kann nicht in Verbindung mit lMinimumverwendet werden.
Bounds.DUMMYSTRUCTNAME2.dwMaximum
Maximaler nicht signierter Wert für ein Steuerelement, das eine nicht signierte Begrenzungsnatur aufweist. Dieses Element kann nicht in Verbindung mit lMaximumverwendet werden.
Bounds.dwReserved[6]
Reserviert; nicht verwenden.
Metrics
Vereinigung von Grenzmetriken.
Metrics.cSteps
Die Anzahl der einzelnen Bereiche innerhalb der Union, die für ein steuerelement angegeben wird, das vom Bounds Member angegeben wird. Dieses Element überlappt mit den anderen Membern des Metrics Strukturmember und kann nicht in Verbindung mit diesen Mitgliedern verwendet werden.
Metrics.cbCustomData
Größe in Bytes, die erforderlich ist, um den Status einer benutzerdefinierten Steuerelementklasse zu enthalten. Dieses Element ist nur für die MIXERCONTROL_CONTROLTYPE_CUSTOM Steuerelementklasse geeignet.
Metrics.dwReserved[6]
Reserviert; nicht verwenden.
Bemerkungen
Anmerkung
Der mmeapi.h-Header definiert MIXERCONTROL als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Header- | mmeapi.h |
Siehe auch
Audiomixer