Structure JOYINFOEX (joystickapi.h)
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