MIXERLINECONTROLS-Struktur (mmeapi.h)
Die MIXERLINECONTROLS-Struktur enthält Informationen zu den Steuerelementen einer Audiozeile.
Syntax
typedef struct tMIXERLINECONTROLS {
DWORD cbStruct;
DWORD dwLineID;
union {
DWORD dwControlID;
DWORD dwControlType;
};
DWORD cControls;
DWORD cbmxctrl;
LPMIXERCONTROL pamxctrl;
} MIXERLINECONTROLS, *PMIXERLINECONTROLS, *LPMIXERLINECONTROLS;
Members
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.
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.
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.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | mmeapi.h |