Structure JOYCAPSA (joystickapi.h)

Article
08/24/2023

La structure JOYCAPS contient des informations sur les fonctionnalités du joystick.

Syntaxe

typedef struct tagJOYCAPSA {
  WORD wMid;
  WORD wPid;
  CHAR szPname[MAXPNAMELEN];
  UINT wXmin;
  UINT wXmax;
  UINT wYmin;
  UINT wYmax;
  UINT wZmin;
  UINT wZmax;
  UINT wNumButtons;
  UINT wPeriodMin;
  UINT wPeriodMax;
  UINT wRmin;
  UINT wRmax;
  UINT wUmin;
  UINT wUmax;
  UINT wVmin;
  UINT wVmax;
  UINT wCaps;
  UINT wMaxAxes;
  UINT wNumAxes;
  UINT wMaxButtons;
  CHAR szRegKey[MAXPNAMELEN];
  CHAR szOEMVxD[MAX_JOYSTICKOEMVXDNAME];
} JOYCAPSA, *PJOYCAPSA, *NPJOYCAPSA, *LPJOYCAPSA;

Membres

wMid

Identificateur du fabricant. Les identificateurs de fabricant sont définis dans Identificateurs de fabricant et de produit.

wPid

Identificateur de produit. Les identificateurs de produit sont définis dans Identificateurs de fabricant et de produit.

szPname[MAXPNAMELEN]

Chaîne terminée par null contenant le nom du produit de la manette de jeu.

wXmin

Coordonnée X minimale.

wXmax

Coordonnée X maximale.

wYmin

Coordonnée Y minimale.

wYmax

Coordonnée Y maximale.

wZmin

Coordonnée Z minimale.

wZmax

Coordonnée Z maximale.

wNumButtons

Nombre de boutons de manette de jeu.

wPeriodMin

Plus petite fréquence d’interrogation prise en charge lorsqu’elle est capturée par la fonction joySetCapture .

wPeriodMax

Fréquence d’interrogation la plus élevée prise en charge lorsqu’elle est capturée par joySetCapture.

wRmin

Valeur de gouvernail minimale. Le gouvernail est un quatrième axe de mouvement.

wRmax

Valeur maximale du gouvernail. Le gouvernail est un quatrième axe de mouvement.

wUmin

Valeurs minimales de coordonnées U (cinquième axe).

wUmax

Valeurs maximales de coordonnées U (cinquième axe).

wVmin

Valeurs minimales de coordonnées v (sixième axe).

wVmax

Valeurs maximales de coordonnées V (sixième axe).

wCaps

Fonctionnalités du joystick Les indicateurs suivants définissent les fonctionnalités individuelles qu’un joystick peut avoir :

Indicateur	Description
JOYCAPS_HASZ	Le joystick contient des informations de coordonnées z.
JOYCAPS_HASR	Le joystick a des informations de gouvernail (quatrième axe).
JOYCAPS_HASU	Le joystick a des informations de coordonnées U (cinquième axe).
JOYCAPS_HASV	Le joystick a des informations de coordonnées V (sixième axe).
JOYCAPS_HASPOV	Le joystick contient des informations de point de vue.
JOYCAPS_POV4DIR	Le point de vue du joystick prend en charge les valeurs discrètes (centrées, avant, arrière, gauche et droite).
JOYCAPS_POVCTS	Le point de vue du joystick prend en charge les roulements de degrés continus.

wMaxAxes

Nombre maximal d’axes pris en charge par le joystick.

wNumAxes

Nombre d’axes actuellement utilisés par le joystick.

wMaxButtons

Nombre maximal de boutons pris en charge par le joystick.

szRegKey[MAXPNAMELEN]

Chaîne terminée par un caractère Null contenant la clé de Registre du joystick.

szOEMVxD[MAX_JOYSTICKOEMVXDNAME]

Chaîne terminée par null identifiant l’OEM du pilote de manette de jeu.

Notes

L’en-tête joystickapi.h définit JOYCAPS 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]
En-tête	joystickapi.h (inclure Windows.h)

Voir aussi

Joysticks

Structures de joystick multimédia

joySetCapture

Partager via