joyGetDevCapsA, fonction (joystickapi.h)

La fonction joyGetDevCaps interroge un joystick pour déterminer ses capacités.

Syntaxe

MMRESULT joyGetDevCapsA(
  UINT_PTR   uJoyID,
  LPJOYCAPSA pjc,
  UINT       cbjc
);

Paramètres

uJoyID

Identificateur du joystick à interroger. Valeurs valides pour plage de uJoyID comprise entre -1 et 15. Une valeur de -1 permet la récupération du membre szRegKey de la structure JOYCAPS si un appareil est présent ou non.

pjc

Pointeur vers une structure JOYCAPS pour contenir les capacités du joystick.

cbjc

Taille, en octets, de la structure JOYCAPS.

Valeur de retour

Retourne JOYERR_NOERROR en cas de réussite ou l’une des valeurs d’erreur suivantes :

Retourner le code	Description
MMSYSERR_NODRIVER	Le pilote du joystick n’est pas présent ou l’identificateur de joystick spécifié n’est pas valide. L’identificateur de joystick spécifié n’est pas valide.
MMSYSERR_INVALPARAM	Un paramètre non valide a été passé.

Remarques

Utilisez la fonction joyGetNumDevs pour déterminer le nombre d’appareils joystick pris en charge par le pilote.

Cette méthode échoue lorsqu’elle a passé une valeur non valide pour le paramètre cbjc .

Note

L’en-tête joystickapi.h définit joyGetDevCaps 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	joystickapi.h (inclure Windows.h)
bibliothèque	Winmm.lib
DLL	Winmm.dll

Voir aussi

joysticks
fonctions joystick multimédia