Partager via

fonction joyGetDevCapsW (joystickapi.h)

  • Article

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

Syntaxe

MMRESULT joyGetDevCapsW(
  UINT_PTR   uJoyID,
  LPJOYCAPSW pjc,
  UINT       cbjc
);

Paramètres

uJoyID

Identificateur du joystick à interroger. Les valeurs valides pour uJoyID sont comprises entre -1 et 15. La valeur -1 permet de récupérer le membre szRegKey de la structure JOYCAPS , qu’un appareil soit présent ou non.

pjc

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

cbjc

Taille, en octets, de la structure JOYCAPS .

Valeur retournée

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

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

Notes

Utilisez la fonction joyGetNumDevs pour déterminer le nombre de joysticks pris en charge par le pilote.

Cette méthode échoue quand une valeur non valide est passée pour le paramètre cbjc .

Notes

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

Configuration requise

   
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 joystickapi.h (inclure Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll

Voir aussi

Joysticks

Fonctions de manette de jeu multimédia