mixerGetLineControls-Funktion (mmeapi.h)

Artikel
08/24/2023

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

Syntax

MMRESULT mixerGetLineControls(
  HMIXEROBJ           hmxobj,
  LPMIXERLINECONTROLS pmxlc,
  DWORD               fdwControls
);

Parameter

hmxobj

Handle für das Mixergerä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 sollen, die einer Audiozeile zugeordnet sind. Das cbStruct-Element der MIXERLINECONTROLS-Struktur muss immer so initialisiert werden, dass es die Größe der MIXERLINECONTROLS-Struktur in Bytes hat.

fdwControls

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

Wert	Bedeutung
MIXER_GETLINECONTROLSF_ALL	Der pmxlc-Parameter verweist auf eine Liste von MIXERCONTROL-Strukturen , die Informationen zu allen Steuerelementen erhalten, die der Audiozeile zugeordnet sind, die vom dwLineID-Member der MIXERLINECONTROLS-Struktur identifiziert wird. Das cControls-Element muss für die Anzahl der Steuerelemente initialisiert werden, die der Zeile zugeordnet sind. Diese Zahl wird aus dem cControls-Element der MIXERLINE-Struktur abgerufen, das von der mixerGetLineInfo-Funktion zurückgegeben wird. Das cbmxctrl-Element muss für die Größe einer einzelnen MIXERCONTROL-Struktur in Bytes initialisiert werden. Das pamxctrl-Element muss auf die erste MIXERCONTROL-Struktur verweisen, die ausgefüllt werden soll. Die DwControlID - und dwControlType-Member werden für diese Abfrage ignoriert.
MIXER_GETLINECONTROLSF_ONEBYID	Der pmxlc-Parameter verweist auf eine einzelne MIXERCONTROL-Struktur , die Informationen zu dem Steuerelement empfängt, das vom dwControlID-Member der MIXERLINECONTROLS-Struktur identifiziert wird. Das cControls-Element muss mit 1 initialisiert werden. Das cbmxctrl-Element muss für die Größe einer einzelnen MIXERCONTROL-Struktur in Bytes initialisiert werden. Das pamxctrl-Element muss auf eine MIXERCONTROL-Struktur verweisen, die gefüllt werden soll. Die DwLineID - und dwControlType-Member werden für diese Abfrage ignoriert. Diese Abfrage wird normalerweise verwendet, um ein Steuerelement zu aktualisieren, nachdem eine MM_MIXM_CONTROL_CHANGE Ä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 zum spezifischen Steuerelement empfängt. Die Audiozeile wird durch das dwLineID-Element identifiziert. Die Steuerelementklasse wird im dwControlType-Member der MIXERLINECONTROLS-Struktur angegeben. Das dwControlID-Element 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. Beispielsweise sollten Sie für Ihre Anwendung eine Spitzenmessung nur über eine Waveform-Audio-Ausgabelinie verwenden.
MIXER_OBJECTF_AUX	Der hmxobj-Parameter ist ein Hilfsgerätebezeichner im Bereich von null bis eins kleiner als die Anzahl von Geräten, die von der auxGetNumDevs-Funktion zurückgegeben werden.
MIXER_OBJECTF_HMIDIIN	Der hmxobj-Parameter ist das Handle eines MIDI-Eingabegeräts. Dieses Handle muss von der midiInOpen-Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIDIOUT	Der hmxobj-Parameter ist das Handle eines MIDI-Ausgabegeräts. Dieses Handle muss von der midiOutOpen-Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIXER	Der hmxobj-Parameter ist ein Von der mixerOpen-Funktion zurückgegebenes Mischerhandle. Dieses Flag ist optional.
MIXER_OBJECTF_HWAVEIN	Der hmxobj-Parameter ist ein Waveform-Audio-Eingabehandle, das von der waveInOpen-Funktion zurückgegeben wird.
MIXER_OBJECTF_HWAVEOUT	Der hmxobj-Parameter ist ein Waveform-Audioausgabehandle, das 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 eins unter der Anzahl der von der midiInGetNumDevs-Funktion zurückgegebenen Geräte befinden.
MIXER_OBJECTF_MIDIOUT	Der hmxobj-Parameter ist der Bezeichner eines MIDI-Ausgabegeräts. Dieser Bezeichner muss sich im Bereich von null bis 1 kleiner als die Anzahl der von der midiOutGetNumDevs-Funktion zurückgegebenen Geräte befinden.
MIXER_OBJECTF_MIXER	Der hmxobj-Parameter ist der Bezeichner eines Mixergeräts im Bereich von null bis eins kleiner als die Anzahl der geräte, die von der mixerGetNumDevs-Funktion zurückgegeben werden. Dieses Flag ist optional.
MIXER_OBJECTF_WAVEIN	Der hmxobj-Parameter ist der Bezeichner eines Waveform-Audio-Eingabegeräts im Bereich von null bis eins kleiner als die Anzahl von Geräten, 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 eins kleiner als die Anzahl von Geräten, die von der waveOutGetNumDevs-Funktion zurückgegeben werden.

Rückgabewert

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

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mmeapi.h (einschließlich Windows.h)
Bibliothek	Winmm.lib
DLL	Winmm.dll

Weitere Informationen

Audiomischerfunktionen

Audiomischer

Freigeben über