fonction joyGetPosEx (joystickapi.h)

  • Article

La fonction joyGetPosEx interroge un joystick pour sa position et son status de bouton.

Syntaxe

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

Paramètres

uJoyID

Identificateur du joystick à interroger. Valeurs valides pour la plage uJoyID comprise entre zéro (JOYSTICKID1) et 15.

pji

Pointeur vers une structure JOYINFOEX qui contient des informations de position étendues et des status de bouton du joystick. Vous devez définir les membres dwSize et dwFlags pour que joyGetPosEx échoue. Les informations retournées par joyGetPosEx dépendent des indicateurs que vous spécifiez dans dwFlags.

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 du joystick n’est pas présent.
MMSYSERR_INVALPARAM
 Un paramètre non valide a été passé.
MMSYSERR_BADDEVICEID
 L’identificateur de joystick spécifié n’est pas valide.
JOYERR_UNPLUGGED
 Le joystick spécifié n’est pas connecté au système.
JOYERR_PARMS
 L’identificateur de joystick spécifié n’est pas valide.

Remarques

Cette fonction permet d’accéder aux appareils étendus tels que les pédales de gouvernail, les chapeaux de point de vue, les appareils dotés d’un grand nombre de boutons et les systèmes de coordonnées utilisant jusqu’à six axes. Pour les joysticks qui utilisent trois axes ou moins et qui ont moins de quatre boutons, utilisez la fonction joyGetPos .

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

Voir aussi

Joysticks

Fonctions du joystick multimédia