auxGetDevCapsA, fonction (mmeapi.h)
La fonction auxGetDevCaps récupère les fonctionnalités d’un périphérique de sortie auxiliaire donné.
Syntaxe
MMRESULT auxGetDevCapsA(
UINT_PTR uDeviceID,
LPAUXCAPSA pac,
UINT cbac
);
Paramètres
uDeviceID
Identificateur du périphérique de sortie auxiliaire à interroger. Spécifiez un identificateur d’appareil valide (voir la section commentaires suivante) ou utilisez la constante suivante :
Valeur | Signification |
---|---|
AUX_MAPPER | Mappeur audio auxiliaire. La fonction retourne une erreur si aucun mappeur audio auxiliaire n’est installé. |
pac
Pointeur vers une structure AUXCAPS à remplir avec des informations sur les fonctionnalités de l’appareil.
cbac
Taille, en octets, de la structure AUXCAPS .
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. |
Notes
L’identificateur d’appareil dans uDeviceID varie de zéro à un de moins que le nombre d’appareils présents. AUX_MAPPER peuvent également être utilisés. Utilisez la fonction auxGetNumDevs pour déterminer le nombre de périphériques de sortie auxiliaires présents dans le système.
Notes
L’en-tête mmeapi.h définit auxGetDevCaps comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Spécifications
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 |