MIXERLINECONTROLSA-Struktur (mmeapi.h)
Die MIXERLINECONTROLS Struktur enthält Informationen zu den Steuerelementen einer Audiolinie.
Syntax
typedef struct tagMIXERLINECONTROLSA {
DWORD cbStruct;
DWORD dwLineID;
union {
DWORD dwControlID;
DWORD dwControlType;
} DUMMYUNIONNAME;
DWORD cControls;
DWORD cbmxctrl;
LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;
Angehörige
cbStruct
Größe in Byte der MIXERLINECONTROLS- Struktur. Dieses Element muss initialisiert werden, bevor die mixerGetLineControls--Funktion aufgerufen wird. Die in diesem Element angegebene Größe muss groß genug sein, um die MIXERLINECONTROLS- Struktur zu enthalten. Wenn mixerGetLineControls zurückgibt, enthält dieses Element die tatsächliche Größe der zurückgegebenen Informationen. Die zurückgegebenen Informationen überschreiten weder die angeforderte Größe noch sind sie kleiner als die MIXERLINECONTROLS Struktur.
dwLineID
Zeilenbezeichner, für die Steuerelemente abgefragt werden. Dieses Element wird nicht verwendet, wenn das MIXER_GETLINECONTROLSF_ONEBYID Flag für die mixerGetLineControls--Funktion angegeben wird, aber das Mixergerät gibt dieses Element in diesem Fall trotzdem zurück. Die dwControlID- und dwControlType- Elemente werden nicht verwendet, wenn MIXER_GETLINECONTROLSF_ALL angegeben wird.
DUMMYUNIONNAME
DUMMYUNIONNAME.dwControlID
Steuerelementbezeichner des gewünschten Steuerelements. Dieses Element wird mit dem MIXER_GETLINECONTROLSF_ONEBYID Flag für die mixerGetLineControls--Funktion verwendet, um die Steuerelementinformationen des angegebenen Steuerelements abzurufen. Beachten Sie, dass das dwLineID- Mitglied der MIXERLINECONTROLS- Struktur vom Mischgerät zurückgegeben wird und nicht als Eingabeparameter erforderlich ist. Dieses Element überlappt mit dem dwControlType Member und kann nicht in Verbindung mit dem MIXER_GETLINECONTROLSF_ONEBYTYPE Abfragetyp verwendet werden.
DUMMYUNIONNAME.dwControlType
Klasse der gewünschten Steuerelementtypen. Dieses Element wird mit dem MIXER_GETLINECONTROLSF_ONEBYTYPE Flag für die mixerGetLineControls Funktion verwendet, um das erste Steuerelement der angegebenen Klasse in der zeile abzurufen, die durch das dwLineID Member der MIXERLINECONTROLS- Struktur angegeben wird. Dieses Element überlappt mit dem dwControlID Member und kann nicht in Verbindung mit dem MIXER_GETLINECONTROLSF_ONEBYID Abfragetyp verwendet werden. Siehe dwControlType-Memberbeschreibung in MIXERCONTROL.
cControls
Die Anzahl der MIXERCONTROL abzurufenden Strukturelemente. Dieses Element muss von der Anwendung initialisiert werden, bevor die mixerGetLineControls--Funktion aufgerufen wird. Dieses Element kann nur 1 sein, wenn MIXER_GETLINECONTROLSF_ONEBYID oder MIXER_GETLINECONTROLSF_ONEBYTYPE angegeben wird oder der im cControls Member der MIXERLINE- Struktur zurückgegebene Struktur für eine Audiolinie zurückgegeben wird. Dieses Element darf nicht null sein. Wenn eine Audiolinie angibt, dass sie keine Steuerelemente enthält, sollten mixerGetLineControls nicht aufgerufen werden.
cbmxctrl
Größe einer einzelnen MIXERCONTROL- Struktur in Byte. Die in diesem Element angegebene Größe muss mindestens groß genug sein, um die Basis MIXERCONTROL Struktur zu enthalten. Die Gesamtgröße in Bytes, die für den Puffer erforderlich ist, auf den das pamxctrl Member verweist, ist das Produkt der cbmxctrl und cControls Member der MIXERLINECONTROLS Struktur.
pamxctrl
Zeigen Sie auf eine oder mehrere MIXERCONTROL- Strukturen, um die Eigenschaften der angeforderten Audioleitungssteuerelemente zu empfangen. Dieses Element kann nicht NULL- werden und muss initialisiert werden, bevor die mixerGetLineControls-Funktion aufgerufen wird. Jedes Element des Arrays von Steuerelementen muss mindestens groß genug sein, um eine Basis MIXERCONTROL Struktur zu enthalten. Das cbmxctrl Member muss die Größe jedes Elements in Byte für jedes Element in diesem Array angeben. Für die Anwendung ist keine Initialisierung des Puffers erforderlich, auf den dieses Element verweist. Alle Elemente werden vom Mischgerät (einschließlich des cbStruct Member jedes MIXERCONTROL Struktur) ausgefüllt, wenn er erfolgreich zurückgegeben wird.
Bemerkungen
Anmerkung
Der mmeapi.h-Header definiert MIXERLINECONTROLS 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 |