Structure JOYCAPSW (joystickapi.h)

Article
08/24/2023

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

Syntaxe

typedef struct tagJOYCAPSW {
  WORD  wMid;
  WORD  wPid;
  WCHAR 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;
  WCHAR szRegKey[MAXPNAMELEN];
  WCHAR szOEMVxD[MAX_JOYSTICKOEMVXDNAME];
} JOYCAPSW, *PJOYCAPSW, *NPJOYCAPSW, *LPJOYCAPSW;

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 joystick.

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 du joystick.

wPeriodMin

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

wPeriodMax

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

wRmin

Valeur minimale du gouvernail. 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 contient des informations sur le gouvernail (quatrième axe).
JOYCAPS_HASU	Le joystick contient des informations de coordonnées U (cinquième axe).
JOYCAPS_HASV	Le joystick contient 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é, avant, arrière, gauche et droite).
JOYCAPS_POVCTS	Le point de vue du joystick prend en charge les paliers de degré 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 null contenant la clé de Registre du joystick.

szOEMVxD[MAX_JOYSTICKOEMVXDNAME]

Chaîne terminée par null identifiant l’OEM du pilote joystick.

Notes

L’en-tête joystickapi.h définit JOYCAPS comme un 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. Le mélange 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