mixerGetID-Funktion (mmeapi.h)

  • Artikel

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