mixerGetID, fonction (mmeapi.h)
La fonction mixerGetID récupère l’identificateur d’appareil d’un appareil de mélangeur associé à un handle d’appareil spécifié.
Syntaxe
MMRESULT mixerGetID(
HMIXEROBJ hmxobj,
UINT *puMxId,
DWORD fdwId
);
Paramètres
hmxobj
Handle vers l’objet mixer audio à mapper à un identificateur d’appareil mixer.
puMxId
Pointeur vers une variable qui reçoit l’identificateur de l’appareil mixer. Si aucun appareil de mélangeur n’est disponible pour l’objet hmxobj , la valeur -1 est placée à cet emplacement et la valeur d’erreur MMSYSERR_NODRIVER est retournée.
fdwId
Indicateurs pour le mappage de l’objet mixer hmxobj. Les valeurs suivantes sont définies.
Valeur | Signification |
---|---|
MIXER_OBJECTF_AUX | Le paramètre hmxobj est un identificateur d’appareil auxiliaire compris entre zéro et un de moins que le nombre d’appareils retourné par la fonction auxGetNumDevs . |
MIXER_OBJECTF_HMIDIIN | Le paramètre hmxobj est le handle d’un périphérique d’entrée MIDI. Ce handle doit avoir été retourné par la fonction midiInOpen . |
MIXER_OBJECTF_HMIDIOUT | Le paramètre hmxobj est le handle d’un périphérique de sortie MIDI. Ce handle doit avoir été retourné par la fonction midiOutOpen . |
MIXER_OBJECTF_HMIXER | Le paramètre hmxobj est une poignée de périphérique de mélangeur retournée par la fonction mixerOpen . Cet indicateur est facultatif. |
MIXER_OBJECTF_HWAVEIN | Le paramètre hmxobj est un handle d’entrée audio de forme d’onde retourné par la fonction waveInOpen . |
MIXER_OBJECTF_HWAVEOUT | Le paramètre hmxobj est un handle de sortie audio de forme d’onde retourné par la fonction waveOutOpen . |
MIXER_OBJECTF_MIDIIN | Le paramètre hmxobj est l’identificateur d’un périphérique d’entrée MIDI. Cet identificateur doit être compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction midiInGetNumDevs . |
MIXER_OBJECTF_MIDIOUT | Le paramètre hmxobj est l’identificateur d’un périphérique de sortie MIDI. Cet identificateur doit être compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction midiOutGetNumDevs . |
MIXER_OBJECTF_MIXER | Le paramètre hmxobj est l’identificateur d’un appareil mixer compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction mixerGetNumDevs . Cet indicateur est facultatif. |
MIXER_OBJECTF_WAVEIN | Le paramètre hmxobj est l’identificateur d’un périphérique d’entrée audio de forme d’onde dans la plage de zéro à un de moins que le nombre d’appareils retournés par la fonction waveInGetNumDevs . |
MIXER_OBJECTF_WAVEOUT | Le paramètre hmxobj est l’identificateur d’un appareil de sortie audio de forme d’onde dans la plage de zéro à un de moins que le nombre d’appareils retournés par la fonction waveOutGetNumDevs . |
Valeur retournée
Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
Code de retour | Description |
---|---|
|
Le paramètre hmxobj spécifie un identificateur d’appareil non valide. |
|
Un ou plusieurs indicateurs ne sont pas valides. |
|
Le paramètre hmxobj spécifie un handle non valide. |
|
Un ou plusieurs paramètres ne sont pas valides. |
|
Aucun appareil de mixage audio n’est disponible pour l’objet spécifié par hmxobj. L’emplacement référencé par puMxId contient également la valeur -1. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | mmeapi.h (inclure Windows.h) |
Bibliothèque | Winmm.lib |
DLL | Winmm.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour