mixerGetLineInfoW-Funktion (mmeapi.h)
Die mixerGetLineInfo-Funktion ruft Informationen zu einer bestimmten Zeile eines Mixergeräts ab.
Syntax
MMRESULT mixerGetLineInfoW(
HMIXEROBJ hmxobj,
LPMIXERLINEW pmxl,
DWORD fdwInfo
);
Parameter
hmxobj
Handle mit dem Mischergerätobjekt, das die bestimmte Audioleitung steuert.
pmxl
Zeiger auf eine MIXERLINE-Struktur . Diese Struktur ist mit Informationen zur Audioleitung für das Mixergerät gefüllt. Das cbStruct-Element muss immer initialisiert werden, um die Größe (in Bytes) der MIXERLINE-Struktur zu sein.
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-Member der MIXERLINE-Struktur angegeben ist. Dieses Flag wird verwendet, um Informationen zu einer Audiozeile eines bestimmten Komponententyps abzurufen. Die restlichen Strukturmember mit Ausnahme von cbStruct erfordern keine weitere Initialisierung. |
| MIXER_GETLINEINFOF_DESTINATION | Der parameter pmxl empfängt Informationen über die Zielaudioleitung, die vom dwDestinationselement der MIXERLINE-Struktur angegeben wird. Dieser Index reicht von null bis eins kleiner als der Wert im cDestinations-Member 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-Member der MIXERLINE-Struktur angegeben wird. Dies wird in der Regel verwendet, um aktualisierte Informationen über den Zustand einer Audioleitung abzurufen. Alle verbleibenden Strukturmember mit Ausnahme von cbStruct erfordern keine weitere Initialisierung. |
| MIXER_GETLINEINFOF_SOURCE | Der parameter pmxl empfängt Informationen über die Quellaudioleitung, die durch die dwDestination - und dwSource-Member der MIXERLINE-Struktur angegeben wird. Der durch dwDestination angegebene Index reicht von null bis eins kleiner als der Wert im cDestinations-Member der MIXERCAPS-Struktur . Der von dwSource angegebene Index reicht von null bis eins kleiner als der Wert im cConnections-Member der MIXERLINE-Struktur , der für die im dwDestination-Member 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 das dwType-Element der Target-Struktur ist, das 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 restlichen 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 MIXER_GETLINEINFOF_TARGETTYPE-Flag 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 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 ein Mixergerätebezeichner 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 |
|---|---|
|
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 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 nicht codierungsneutralem Code 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ßlich 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