mixerGetLineControlsW-Funktion (mmeapi.h)

Artikel
11/20/2024

Die mixerGetLineControls Funktion ruft ein oder mehrere Steuerelemente ab, die einer Audiolinie zugeordnet sind.

Syntax

MMRESULT mixerGetLineControlsW(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSW pmxlc,
  DWORD                fdwControls
);

Parameter

hmxobj

Behandeln Sie das Mischgerätobjekt, das abgefragt wird.

pmxlc

Zeiger auf eine MIXERLINECONTROLS- Struktur. Diese Struktur wird verwendet, um auf eine oder mehrere MIXERCONTROL- Strukturen zu verweisen, die mit Informationen zu den Steuerelementen gefüllt werden, die einer Audiolinie zugeordnet sind. Das cbStruct Member der MIXERLINECONTROLS- Struktur muss immer initialisiert werden, damit sie die Größe der MIXERLINECONTROLS- Struktur in Byte aufweist.

fdwControls

Flags zum Abrufen von Informationen zu einem oder mehreren Steuerelementen, die einer Audiolinie zugeordnet sind. Die folgenden Werte sind definiert.

Wert	Bedeutung
MIXER_GETLINECONTROLSF_ALL	Der pmxlc Parameter verweist auf eine Liste der MIXERCONTROL- Strukturen, die Informationen zu allen Steuerelementen erhalten, die mit der Audiolinie verknüpft sind, die durch das dwLineID- Mitglied der MIXERLINECONTROLS- Struktur identifiziert werden. Das cControls-element muss an die Anzahl der Steuerelemente initialisiert werden, die der Zeile zugeordnet sind. Diese Zahl wird aus dem cControls Member der MIXERLINE Struktur abgerufen, die von der funktion mixerGetLineInfo zurückgegeben wird. Das cbmxctrl Member muss in Byte einer einzelnen MIXERCONTROL Struktur initialisiert werden. Das pamxctrl Member muss auf die erste MIXERCONTROL- struktur verweisen, die gefüllt werden soll. Die dwControlID- und dwControlType- Elemente werden für diese Abfrage ignoriert.
MIXER_GETLINECONTROLSF_ONEBYID	Der pmxlc Parameter verweist auf eine einzelne MIXERCONTROL Struktur, die Informationen zu dem steuerelement erhält, das vom dwControlID Member der MIXERLINECONTROLS Struktur identifiziert wird. Das cControls Member muss auf 1 initialisiert werden. Das cbmxctrl Member muss in Byte einer einzelnen MIXERCONTROL Struktur initialisiert werden. Das pamxctrl Member muss auf eine MIXERCONTROL- Struktur verweisen, die gefüllt werden soll. Die dwLineID- und dwControlType- Elemente werden für diese Abfrage ignoriert. Diese Abfrage wird in der Regel verwendet, um ein Steuerelement zu aktualisieren, nachdem eine MM_MIXM_CONTROL_CHANGE Steuerelementänderungsbenachrichtigung durch den benutzerdefinierten Rückruf empfangen wurde (siehe mixerOpen).
MIXER_GETLINECONTROLSF_ONEBYTYPE	Die mixerGetLineControls--Funktion ruft Informationen zum ersten Steuerelement einer bestimmten Klasse für die abgefragte Audiozeile ab. Der pmxlc Parameter verweist auf eine einzelne MIXERCONTROL Struktur, die Informationen über das jeweilige Steuerelement erhält. Die Audiozeile wird durch das dwLineID Member identifiziert. Die Steuerelementklasse wird im dwControlType Member der MIXERLINECONTROLS- Struktur angegeben. Der dwControlID Member wird für diese Abfrage ignoriert. Diese Abfrage kann von einer Anwendung verwendet werden, um Informationen zu einem einzelnen Steuerelement abzurufen, das einer Zeile zugeordnet ist. Sie können z. B. möchten, dass Ihre Anwendung nur einen Spitzenzähler aus einer Waveform-Audioausgabelinie verwendet.
MIXER_OBJECTF_AUX	Der hmxobj Parameter ist ein Hilfsgerätebezeichner im Bereich von 0 bis 1 kleiner als die Anzahl der von der auxGetNumDevs Funktion zurückgegebenen Geräte.
MIXER_OBJECTF_HMIDIIN	Der hmxobj Parameter ist das Handle eines MIDI-Eingabegeräts. Dieser Handle muss von der midiInOpen--Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIDIOUT	Der hmxobj Parameter ist der Handle eines MIDI-Ausgabegeräts. Dieser Handle muss von der midiOutOpen--Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIXER	Der hmxobj Parameter ist ein Mischgeräthandle, das von der funktion mixerOpen zurückgegeben wird. Dieses Kennzeichen ist optional.
MIXER_OBJECTF_HWAVEIN	Der hmxobj Parameter ist ein Waveform-Audio-Eingabepunkt, der von der waveInOpen--Funktion zurückgegeben wird.
MIXER_OBJECTF_HWAVEOUT	Der hmxobj Parameter ist ein Waveform-Audioausgabepunkt, der von der waveOutOpen--Funktion zurückgegeben wird.
MIXER_OBJECTF_MIDIIN	Der hmxobj Parameter ist der Bezeichner eines MIDI-Eingabegeräts. Dieser Bezeichner muss sich im Bereich von Null bis 1 kleiner befinden als die Anzahl der Geräte, die von der midiInGetNumDevs Funktion zurückgegeben werden.
MIXER_OBJECTF_MIDIOUT	Der hmxobj Parameter ist der Bezeichner eines MIDI-Ausgabegeräts. Dieser Bezeichner muss sich im Bereich von 0 bis 1 kleiner befinden als die Anzahl der Geräte, die von der midiOutGetNumDevs Funktion zurückgegeben werden.
MIXER_OBJECTF_MIXER	Der hmxobj Parameter ist der Bezeichner eines Mischgeräts im Bereich von 0 bis 1 kleiner als die Anzahl der von der mixerGetNumDevs Funktion zurückgegebenen Geräte. Dieses Kennzeichen ist optional.
MIXER_OBJECTF_WAVEIN	Der hmxobj Parameter ist der Bezeichner eines Waveform-Audioeingabegeräts im Bereich von Null bis 1 kleiner als die Anzahl der geräte, die von der waveInGetNumDevs Funktion zurückgegeben werden.
MIXER_OBJECTF_WAVEOUT	Der hmxobj Parameter ist der Bezeichner eines Waveform-Audioausgabegeräts im Bereich von Null bis 1 kleiner als die Anzahl der geräte, die von der waveOutGetNumDevs Funktion zurückgegeben werden.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
MIXERR_INVALCONTROL	Der Steuerelementverweis ist ungültig.
MIXERR_INVALLINE	Der Audiozeilenverweis ist ungültig.
MMSYSERR_BADDEVICEID	Der parameter hmxobj gibt einen ungültigen Gerätebezeichner an.
MMSYSERR_INVALFLAG	Mindestens ein Kennzeichen ist ungültig.
MMSYSERR_INVALHANDLE	Der hmxobj Parameter gibt einen ungültigen Handle an.
MMSYSERR_INVALPARAM	Mindestens ein Parameter ist ungültig.
MMSYSERR_NODRIVER	Für das von hmxobjangegebene Objekt ist kein Mischgerät verfügbar.

Bemerkungen

Anmerkung

Der mmeapi.h-Header definiert mixerGetLineControls 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]
Zielplattform-	Fenster
Header-	mmeapi.h (enthalten Windows.h)
Library	Winmm.lib
DLL-	Winmm.dll

Siehe auch

Audiomixerfunktionen

Audiomixer

Freigeben über