mixerGetLineInfoA-Funktion (mmeapi.h)

Artikel
11/20/2024

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

Syntax

MMRESULT mixerGetLineInfoA(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEA pmxl,
  DWORD        fdwInfo
);

Parameter

hmxobj

Handle to the mixer device object that controls the specific audio line.

pmxl

Zeiger auf eine MIXERLINE- Struktur. Diese Struktur wird mit Informationen über die Audiolinie für das Mixergerät gefüllt. Das cbStruct Member muss immer initialisiert werden, um die Größe der MIXERLINE- Struktur in Byte zu sein.

fdwInfo

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

Wert	Bedeutung
MIXER_GETLINEINFOF_COMPONENTTYPE	Der pmxl Parameter erhält Informationen über die erste Audiozeile des Typs, der im dwComponentType Member der MIXERLINE Struktur angegeben ist. Dieses Kennzeichen wird verwendet, um Informationen zu einer Audiozeile eines bestimmten Komponententyps abzurufen. Verbleibende Strukturmmber außer cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_DESTINATION	Der parameter pmxl empfängt Informationen über die zielaudiolinie, die durch die dwDestination Member der MIXERLINE Struktur angegeben wird. Dieser Index reicht von Null bis 1 kleiner als der Wert im cDestinations Member der MIXERCAPS Struktur. Alle verbleibenden Strukturmmber außer cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_LINEID	Der parameter pmxl empfängt Informationen über die Audiolinie, die vom dwLineID Member der MIXERLINE Struktur angegeben wird. Dies wird in der Regel verwendet, um aktualisierte Informationen zum Status einer Audiozeile abzurufen. Alle verbleibenden Strukturmmber außer cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_SOURCE	Der parameter pmxl empfängt Informationen zur Quellaudiolinie, die durch die dwDestination und dwSource Member der MIXERLINE Struktur angegeben wird. Der durch dwDestination angegebene Index reicht von Null bis 1 kleiner als der Wert im cDestinations Member der MIXERCAPS Struktur. Der durch dwSource- angegebene Index reicht von Null bis 1 kleiner als der Wert im cConnections Member der MIXERLINE Struktur, die für die im dwDestination Member gespeicherte Audiolinie zurückgegeben wird. Alle verbleibenden Strukturmmber außer cbStruct erfordern keine weitere Initialisierung.
MIXER_GETLINEINFOF_TARGETTYPE	Der parameter pmxl empfängt Informationen über die Audiolinie, die sich für das dwType- Mitglied der Target-Struktur befindet, bei dem es sich um ein Element der MIXERLINE Struktur handelt. Dieses Flag wird verwendet, um Informationen zu einer Audiozeile abzurufen, die den Zieltyp behandelt (z. B. MIXERLINE_TARGETTYPE_WAVEOUT). Die Anwendung muss die dwType, wMid, wPid, vDriverVersion und szPname Member der MIXERLINE Struktur initialisieren, bevor mixerGetLineInfoaufgerufen wird. Alle diese Werte können aus den Gerätefunktionenstrukturen für alle Mediengeräte abgerufen werden. Verbleibende Strukturmmber außer cbStruct erfordern keine weitere Initialisierung. Hinweis In der ANSI-Version dieser Funktion (mixerGetLineInfoA), können Sie die VON mixerGetLineInfo oder waveOutGetDevCaps für den Wert der psPname Zeichenfolge nicht verwenden, wenn Sie mixerGetLineInfo mit der MIXER_GETLINEINFOF_TARGETTYPE Kennzeichnung aufrufen. Der Grund dafür ist, dass eine interne Konvertierung in und von Unicode durchgeführt wird, was zu Datenverlust führen kann.
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 ein Mischgerätbezeichner 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_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 mixerGetLineInfo 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

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