MIXERLINECONTROLSA-Struktur (mmeapi.h)

Artikel
08/24/2023

Die MIXERLINECONTROLS-Struktur enthält Informationen zu den Steuerelementen einer Audiozeile.

Syntax

typedef struct tagMIXERLINECONTROLSA {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;

Member

cbStruct

Größe der MIXERLINECONTROLS-Struktur in Byte. Dieser Member muss initialisiert werden, bevor die Funktion mixerGetLineControls aufgerufen wird. Die in diesem Member 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 nicht die angeforderte Größe und sind auch nicht kleiner als die MIXERLINECONTROLS-Struktur .

dwLineID

Zeilenbezeichner, für die Steuerelemente abgefragt werden. Dieser Member wird nicht verwendet, wenn das flag MIXER_GETLINECONTROLSF_ONEBYID für die mixerGetLineControls-Funktion angegeben ist, aber das Mixergerät gibt diesen Member in diesem Fall trotzdem zurück. Die Elemente dwControlID und dwControlType werden nicht verwendet, wenn MIXER_GETLINECONTROLSF_ALL angegeben wird.

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

Steuerelementbezeichner des gewünschten Steuerelements. Dieser Member wird mit dem flag MIXER_GETLINECONTROLSF_ONEBYID für die mixerGetLineControls-Funktion verwendet, um die Steuerelementinformationen des angegebenen Steuerelements abzurufen. Beachten Sie, dass der dwLineID-Member der MIXERLINECONTROLS-Struktur vom Mixergerät zurückgegeben wird und nicht als Eingabeparameter erforderlich ist. Dieser Member überlappt sich mit dem dwControlType-Member und kann nicht in Verbindung mit dem MIXER_GETLINECONTROLSF_ONEBYTYPE Abfragetyp verwendet werden.

DUMMYUNIONNAME.dwControlType

Klasse der gewünschten Steuerelementtypen. Dieser Member 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 vom dwLineID-Member der MIXERLINECONTROLS-Struktur angegeben wird. Dieser Member überlappt sich mit dem dwControlID-Member und kann nicht in Verbindung mit dem abfragetyp MIXER_GETLINECONTROLSF_ONEBYID verwendet werden. Weitere Informationen finden Sie unter dwControlType-Memberbeschreibung in MIXERCONTROL.

cControls

Anzahl der abzurufenden MIXERCONTROL-Strukturelemente . Dieser Member muss von der Anwendung initialisiert werden, bevor die Funktion mixerGetLineControls aufgerufen wird. Dieser Member kann nur 1 sein, wenn MIXER_GETLINECONTROLSF_ONEBYID oder MIXER_GETLINECONTROLSF_ONEBYTYPE angegeben ist oder der wert im cControls-Element der MIXERLINE-Struktur zurückgegeben wird, der für eine Audiozeile zurückgegeben wird. Dieser Member darf nicht 0 (null) sein. Wenn eine Audiozeile angibt, dass sie über keine Steuerelemente verfügt, sollte mixerGetLineControls nicht aufgerufen werden.

cbmxctrl

Größe einer einzelnen MIXERCONTROL-Struktur in Byte. Die in diesem Member angegebene Größe muss mindestens groß genug sein, um die MIXERCONTROL-Basisstruktur zu enthalten. Die Gesamtgröße in Bytes, die für den Puffer erforderlich ist, auf den der pamxctrl-Member verweist, ist das Produkt der elemente cbmxctrl und cControls der MIXERLINECONTROLS-Struktur .

pamxctrl

Zeiger auf eine oder mehrere MIXERCONTROL-Strukturen , um die Eigenschaften der angeforderten Audiozeilensteuerelemente zu empfangen. Dieser Member darf nicht NULL sein und muss initialisiert werden, bevor die MixerGetLineControls-Funktion aufgerufen wird. Jedes Element des Arrays von Steuerelementen muss mindestens groß genug sein, um eine MIXERCONTROL-Basisstruktur zu enthalten. Der cbmxctrl-Member muss die Größe jedes Elements in diesem Array in Bytes angeben. Die Anwendung erfordert keine Initialisierung des Puffers, auf den dieses Element verweist. Alle Member werden nach erfolgreicher Rückgabe vom Mischgerät (einschließlich des cbStruct-Elements jeder MIXERCONTROL-Struktur ) ausgefüllt.

Hinweise

Hinweis

Der mmeapi.h-Header definiert MIXERLINECONTROLS 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 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
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