mixerGetDevCaps, fonction (mmeapi.h)
La fonction mixerGetDevCaps interroge un appareil mixer spécifié pour déterminer ses fonctionnalités.
Syntaxe
MMRESULT mixerGetDevCaps(
UINT uMxId,
LPMIXERCAPS pmxcaps,
UINT cbmxcaps
);
Paramètres
uMxId
Identificateur ou handle d’un appareil mixer ouvert.
pmxcaps
Pointeur vers une structure MIXERCAPS qui reçoit des informations sur les fonctionnalités de l’appareil.
cbmxcaps
Taille, en octets, de la structure MIXERCAPS .
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 |
|---|---|
|
L’identificateur d’appareil spécifié est hors limites. |
|
Le handle d’appareil mixer n’est pas valide. |
|
Un ou plusieurs paramètres ne sont pas valides. |
Remarques
Utilisez la fonction mixerGetNumDevs pour déterminer le nombre d’appareils de mélangeur présents dans le système. L’identificateur d’appareil spécifié par uMxId varie de zéro à un de moins que le nombre d’appareils mixer présents.
Seul le nombre d’octets (ou moins) d’informations spécifié dans cbmxcaps est copié à l’emplacement pointé par pmxcaps. Si cbmxcaps est égal à zéro, rien n’est copié et la fonction retourne correctement.
Cette fonction accepte également un handle de périphérique de mélangeur retourné par la fonction mixerOpen comme paramètre uMxId . L’application doit convertir le handle HMIXER en UINT.
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 |