mixerGetLineInfo-Funktion (mmeapi.h)

Artikel
02/29/2024

Die mixerGetLineInfo-Funktion ruft Informationen zu einer bestimmten Linie eines Mixergeräts ab.

Syntax

MMRESULT mixerGetLineInfo(
  HMIXEROBJ   hmxobj,
  LPMIXERLINE pmxl,
  DWORD       fdwInfo
);

Parameter

hmxobj

Handle für das Mixergerätobjekt, das die bestimmte Audiozeile steuert.

pmxl

Zeiger auf eine MIXERLINE-Struktur . Diese Struktur ist mit Informationen über die Audioleitung für das Mixergerät gefüllt. Der cbStruct-Member muss immer so initialisiert werden, dass er die Größe der MIXERLINE-Struktur in Byte aufweist.

fdwInfo

Flags zum Abrufen von Informationen zu einer Audiozeile. Die folgenden Werte werden definiert.

Wert	Bedeutung
MIXER_GETLINEINFOF_COMPONENTTYPE	Der parameter pmxl empfängt Informationen über die erste Audiozeile des Typs, der im dwComponentType-Element der MIXERLINE-Struktur angegeben ist. Dieses Flag wird verwendet, um Informationen zu einer Audiozeile eines bestimmten Komponententyps abzurufen. Die verbleibenden Strukturmember mit Ausnahme von cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_DESTINATION	Der parameter pmxl empfängt Informationen über die Zielaudiozeile, die vom dwDestination-Element der MIXERLINE-Struktur angegeben wird. Dieser Index reicht von null bis eins kleiner als der Wert im cDestinations-Element der MIXERCAPS-Struktur . Alle verbleibenden Strukturmember mit Ausnahme von cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_LINEID	Der parameter pmxl empfängt Informationen über die Audiozeile, die vom dwLineID-Element der MIXERLINE-Struktur angegeben wird. Dies wird in der Regel verwendet, um aktualisierte Informationen über den Zustand einer Audiozeile abzurufen. Alle verbleibenden Strukturmember mit Ausnahme von cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_SOURCE	Der parameter pmxl empfängt Informationen über die Quellaudiozeile, die durch die dwDestination - und dwSource-Elemente der MIXERLINE-Struktur angegeben wird. Der durch dwDestination angegebene Index reicht von null bis 1 kleiner als der Wert im cDestinations-Element der MIXERCAPS-Struktur . Der von dwSource angegebene Index reicht von null bis 1 kleiner als der Wert im cConnections-Member der MIXERLINE-Struktur , der für die im dwDestination-Element gespeicherte Audiozeile zurückgegeben wird. Alle verbleibenden Strukturmember mit Ausnahme von cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_TARGETTYPE	Der parameter pmxl empfängt Informationen über die Audiozeile, die für den dwType-Member der Target-Struktur ist, die ein Element der MIXERLINE-Struktur ist. Dieses Flag wird verwendet, um Informationen zu einer Audiozeile abzurufen, die den Zieltyp verarbeitet (z. B. MIXERLINE_TARGETTYPE_WAVEOUT). Die Anwendung muss die Elemente dwType, wMid, wPid, vDriverVersion und szPname der MIXERLINE-Struktur initialisieren, bevor mixerGetLineInfo aufgerufen wird. Alle diese Werte können aus den Gerätefunktionsstrukturen für alle Mediengeräte abgerufen werden. Die verbleibenden Strukturmember mit Ausnahme von cbStruct erfordern keine weitere Initialisierung. Hinweis In der ANSI-Version dieser Funktion (mixerGetLineInfoA) können Sie die von mixerGetLineInfo oder waveOutGetDevCaps zurückgegebene ANSI-Zeichenfolge nicht für den Wert der psPname-Zeichenfolge verwenden, wenn Sie mixerGetLineInfo mit dem flag MIXER_GETLINEINFOF_TARGETTYPE aufrufen. Der Grund ist, dass eine interne Konvertierung in und aus Unicode durchgeführt wird, was zu Datenverlust führen kann.
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 ein Mixergerätebezeichner im Bereich von 0 bis 1 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 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
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

Anforderung	Wert
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

Audiomischerfunktionen

Audiomischer

Freigeben über