Structure JOYINFOEX (joystickapi.h)

Article
08/24/2023

La structure JOYINFOEX contient des informations étendues sur la position du joystick, la position du point de vue et l’état du bouton.

Syntaxe

typedef struct joyinfoex_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwXpos;
  DWORD dwYpos;
  DWORD dwZpos;
  DWORD dwRpos;
  DWORD dwUpos;
  DWORD dwVpos;
  DWORD dwButtons;
  DWORD dwButtonNumber;
  DWORD dwPOV;
  DWORD dwReserved1;
  DWORD dwReserved2;
} JOYINFOEX, *PJOYINFOEX, *NPJOYINFOEX, *LPJOYINFOEX;

Membres

dwSize

Taille, en octets, de cette structure.

dwFlags

Indicateurs indiquant les informations valides retournées dans cette structure. Les membres qui ne contiennent pas d’informations valides sont définis sur zéro. Les indicateurs suivants sont définis :

Indicateur	Description
JOY_RETURNALL	Équivaut à définir tous les bits JOY_RETURN à l’exception de JOY_RETURNRAWDATA.
JOY_RETURNBUTTONS	Le membre dwButtons contient des informations valides sur l’état de chaque bouton du joystick.
JOY_RETURNCENTERED	Centre la position neutre du joystick sur la valeur médiane de chaque axe de mouvement.
JOY_RETURNPOV	Le membre dwPOV contient des informations valides sur le contrôle de point de vue, exprimées en unités discrètes.
JOY_RETURNPOVCTS	Le membre dwPOV contient des informations valides sur le contrôle de point de vue exprimé en unités continues d’un centième degré.
JOY_RETURNR	Le membre dwRpos contient des données de pédale de gouvernail valides. Ces informations représentent un autre (quatrième) axe.
JOY_RETURNRAWDATA	Les données stockées dans cette structure sont des lectures de joystick non calibrées.
JOY_RETURNU	Le membre dwUpos contient des données valides pour un cinquième axe du joystick, si un tel axe est disponible, ou retourne zéro dans le cas contraire.
JOY_RETURNV	Le membre dwVpos contient des données valides pour un sixième axe du joystick, si un tel axe est disponible, ou retourne zéro dans le cas contraire.
JOY_RETURNX	Le membre dwXpos contient des données valides pour la coordonnée x du joystick.
JOY_RETURNY	Le membre dwYpos contient des données valides pour la coordonnée y du joystick.
JOY_RETURNZ	Le membre dwZpos contient des données valides pour la coordonnée z du joystick.

Les indicateurs suivants fournissent des données pour étalonner un joystick et sont destinés aux applications d’étalonnage personnalisées.

Indicateur	Description
JOY_CAL_READ3	Lisez les coordonnées x, y et z et stockez les valeurs brutes dans dwXpos, dwYpos et dwZpos.
JOY_CAL_READ4	Lisez les informations de gouvernail et les coordonnées x, y et z, et stockez les valeurs brutes dans dwXpos, dwYpos, dwZpos et dwRpos.
JOY_CAL_READ5	Lisez les informations de gouvernail et les coordonnées x, y, z et you, et stockez les valeurs brutes dans dwXpos, dwYpos, dwZpos, dwRpos et dwUpos.
JOY_CAL_READ6	Lisez les données brutes de l’axe V si un mini pilote joystick est présent pour fournir les données. Retourne zéro dans le cas contraire.
JOY_CAL_READALWAYS	Lisez le port du joystick même si le pilote ne détecte pas d’appareil.
JOY_CAL_READRONLY	Lisez les informations de gouvernail si un mini-pilote de manette de jeu est présent pour fournir les données et stocker la valeur brute dans dwRpos. Sinon, retournez zéro.
JOY_CAL_READXONLY	Lisez la coordonnée x et stockez la valeur brute (sans étalonnage) dans dwXpos.
JOY_CAL_READXYONLY	Lit les coordonnées x et y et place les valeurs brutes dans dwXpos et dwYpos.
JOY_CAL_READYONLY	Lit la coordonnée y et stocke la valeur brute dans dwYpos.
JOY_CAL_READZONLY	Lisez la coordonnée z et stockez la valeur brute dans dwZpos.
JOY_CAL_READUONLY	Lisez la coordonnée u si un mini-pilote de manette de jeu est présent pour fournir les données et stocker la valeur brute dans dwUpos. Sinon, retournez zéro.
JOY_CAL_READVONLY	Lisez la coordonnée v si un mini-pilote de manette de jeu est présent pour fournir les données et stocker la valeur brute dans dwVpos. Sinon, retournez zéro.

dwXpos

Coordonnée X actuelle.

dwYpos

Coordonnée Y actuelle.

dwZpos

Coordonnée Z actuelle.

dwRpos

Position actuelle du gouvernail ou du quatrième axe du joystick.

dwUpos

Position actuelle du cinquième axe.

dwVpos

Position actuelle du sixième axe.

dwButtons

État actuel des 32 boutons du joystick. La valeur de ce membre peut être définie sur n’importe quelle combinaison de JOY_BUTTON n indicateurs, où n est une valeur comprise entre 1 et 32 correspondant au bouton enfoncé.

dwButtonNumber

Numéro de bouton actuel sur lequel vous appuyez.

dwPOV

Position actuelle du contrôle de point de vue. Les valeurs de ce membre sont comprises entre 0 et 35 900. Ces valeurs représentent l’angle, en degrés, de chaque vue multipliée par 100.

dwReserved1

Réservé ; ne pas utiliser.

dwReserved2

Réservé ; ne pas utiliser.

Notes

La valeur du membre dwSize est également utilisée pour identifier le numéro de version de la structure lorsqu’il est passé à la fonction joyGetPosEx .

La plupart des appareils avec un contrôle de point de vue n’ont que cinq positions. Lorsque l’indicateur JOY_RETURNPOV est défini, ces positions sont signalées à l’aide des constantes suivantes :

Indicateur point de vue	Description
JOY_POVBACKWARD	Le chapeau de point de vue est appuyé vers l’arrière. La valeur 18 000 représente une orientation de 180,00 degrés (vers l’arrière).
JOY_POVCENTERED	Le chapeau de point de vue est en position neutre. La valeur -1 signifie que le chapeau de point de vue n’a aucun angle à signaler.
JOY_POVFORWARD	Le chapeau de point de vue est appuyé vers l’avant. La valeur 0 représente une orientation de 0,00 degré (droit avant).
JOY_POVLEFT	Le chapeau de point de vue est appuyé vers la gauche. La valeur 27 000 représente une orientation de 270,00 degrés (90,00 degrés à gauche).
JOY_POVRIGHT	Le chapeau de point de vue est enfoncé à droite. La valeur 9 000 représente une orientation de 90,00 degrés (à droite).

Le pilote de joystick par défaut prend actuellement en charge ces cinq directions discrètes. Si une application peut accepter uniquement les valeurs de point de vue définies, elle doit utiliser l’indicateur JOY_RETURNPOV. Si une application peut accepter d’autres lectures de degrés, elle doit utiliser l’indicateur JOY_RETURNPOVCTS pour obtenir des données continues si elles sont disponibles. L’indicateur JOY_RETURNPOVCTS prend également en charge les constantes JOY_POV utilisées avec l’indicateur JOY_RETURNPOV.

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]
En-tête	joystickapi.h (inclure Windows.h)

Voir aussi

Joysticks

Structures de joystick multimédia

joyGetPosEx