mixerGetLineControlsW-Funktion (mmeapi.h)
Die mixerGetLineControls-Funktion ruft ein oder mehrere Steuerelemente ab, die einer Audiozeile zugeordnet sind.
Syntax
MMRESULT mixerGetLineControlsW(
HMIXEROBJ hmxobj,
LPMIXERLINECONTROLSW pmxlc,
DWORD fdwControls
);
Parameter
hmxobj
Handle mit dem Objekt des Mixergeräts, 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. Der cbStruct-Member der MIXERLINECONTROLS-Struktur muss immer so initialisiert werden, dass er die Größe der MIXERLINECONTROLS-Struktur in Bytes aufweist.
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 parameter pmxlc verweist auf eine Liste von MIXERCONTROL-Strukturen , die Informationen zu allen Steuerelementen erhalten, die der Audiozeile zugeordnet sind, die vom dwLineID-Element der MIXERLINECONTROLS-Struktur identifiziert wird. Der cControls-Member muss mit der Anzahl der Steuerelemente initialisiert werden, die der Zeile zugeordnet sind. Diese Zahl wird aus dem cControls-Element der MIXERLINE-Struktur abgerufen, die von der mixerGetLineInfo-Funktion zurückgegeben wird. Der cbmxctrl-Member muss auf die Größe einer einzelnen MIXERCONTROL-Struktur in Bytes initialisiert werden. Der pamxctrl-Member muss auf die erste MIXERCONTROL-Struktur verweisen, die ausgefüllt werden soll. Die Elemente dwControlID und dwControlType werden für diese Abfrage ignoriert. |
| MIXER_GETLINECONTROLSF_ONEBYID | Der parameter pmxlc verweist auf eine einzelne MIXERCONTROL-Struktur , die Informationen zu dem Steuerelement empfängt, das durch den dwControlID-Member der MIXERLINECONTROLS-Struktur identifiziert wird. Das cControls-Element muss mit 1 initialisiert werden. Der cbmxctrl-Member muss auf die Größe einer einzelnen MIXERCONTROL-Struktur in Bytes initialisiert werden. Der pamxctrl-Member muss auf eine MIXERCONTROL-Struktur verweisen, die ausgefüllt werden soll. Die Elemente dwLineID und dwControlType werden für diese Abfrage ignoriert. Diese Abfrage wird normalerweise verwendet, um ein Steuerelement zu aktualisieren, nachdem vom benutzerdefinierten Rückruf eine MM_MIXM_CONTROL_CHANGE Änderungsbenachrichtigung 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 parameter pmxlc 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. 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. Beispielsweise können Sie möchten, dass Ihre Anwendung einen Spitzenzähler nur aus einer Wellenform-Audio-Ausgangslinie verwendet. |
| MIXER_OBJECTF_AUX | Der hmxobj-Parameter ist ein Hilfsgerätebezeichner im Bereich von null bis eins kleiner als die Anzahl der Geräte, 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 Mischer-Gerätehandle, das von der MixerOpen-Funktion zurückgegeben wird. 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-Audio-Ausgabehandle, 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 0 bis eins unter der Anzahl der Geräte befinden, 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 null bis eins unter der Anzahl der Geräte befinden, die von der midiOutGetNumDevs-Funktion zurückgegeben werden. |
| MIXER_OBJECTF_MIXER | Der hmxobj-Parameter ist der Bezeichner eines Mixergeräts im Bereich von 0 bis eins kleiner als die Anzahl von Geräten, 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 0 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 0 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 |
|---|---|
|
Der Steuerelementverweis ist ungültig. |
|
Der Audiozeilenverweis ist ungültig. |
|
Der hmxobj-Parameter gibt einen ungültigen Gerätebezeichner an. |
|
Mindestens ein Flag ist ungültig. |
|
Der hmxobj-Parameter gibt ein ungültiges Handle an. |
|
Mindestens ein Parameter ist ungültig. |
|
Für das von hmxobj angegebene Objekt ist kein Mixergerät verfügbar. |
Hinweise
Hinweis
Der Mmeapi.h-Header definiert mixerGetLineControls 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
| 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ßen von Windows.h) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für