mixerGetID-Funktion (mmeapi.h)

Artikel
08/24/2023

Die mixerGetID-Funktion ruft den Gerätebezeichner für ein Mixergerät ab, das einem angegebenen Gerätehandle zugeordnet ist.

Syntax

MMRESULT mixerGetID(
  HMIXEROBJ hmxobj,
  UINT      *puMxId,
  DWORD     fdwId
);

Parameter

hmxobj

Handle mit dem Audiomischerobjekt, das einem Mixergerätebezeichner zugeordnet werden soll.

puMxId

Zeiger auf eine Variable, die den Gerätebezeichner des Mixers empfängt. Wenn kein Mixergerät für das hmxobj-Objekt verfügbar ist, wird der Wert -1 an dieser Position platziert, und der MMSYSERR_NODRIVER Fehlerwert wird zurückgegeben.

fdwId

Flags zum Zuordnen des Mixerobjekts hmxobj. Die folgenden Werte werden definiert.

Wert	Bedeutung
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
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 Audiomischergerät verfügbar. Der Speicherort, auf den von puMxId verwiesen wird, enthält auch den Wert -1.

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ßlich Windows.h)
Bibliothek	Winmm.lib
DLL	Winmm.dll

Weitere Informationen

Audiomischerfunktionen

Audiomischer

Freigeben über