mixerGetID-Funktion (mmeapi.h)
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 |
|---|---|
|
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 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 |