Struttura JOYCAPSW (joystickapi.h)

Articolo
11/20/2024

La struttura JOYCAPS contiene informazioni sulle funzionalità del joystick.

Sintassi

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;

Membri

wMid

Identificatore del produttore. Gli identificatori del produttore sono definiti in Manufacturer e Product Identifiers.

wPid

Identificatore del prodotto. Gli identificatori di prodotto sono definiti in Manufacturer e Product Identifiers.

szPname[MAXPNAMELEN]

Stringa con terminazione Null contenente il nome del prodotto joystick.

wXmin

Coordinata X minima.

wXmax

Coordinata X massima.

wYmin

Coordinata Y minima.

wYmax

Coordinata Y massima.

wZmin

Coordinata Z minima.

wZmax

Coordinata Z massima.

wNumButtons

Numero di pulsanti joystick.

wPeriodMin

Frequenza di polling più piccola supportata quando acquisita dalla funzione joySetCapture.

wPeriodMax

Frequenza di polling più grande supportata quando acquisita da joySetCapture.

wRmin

Valore minimo del timone. Il timone è un quarto asse di movimento.

wRmax

Valore massimo del timone. Il timone è un quarto asse di movimento.

wUmin

Valori minimi della coordinata u (quinto asse).

wUmax

Valori massimi di coordinate u (quinto asse).

wVmin

Valori minimi della coordinata v (sesto asse).

wVmax

Valori massimi della coordinata v (sesto asse).

wCaps

Funzionalità joystick I flag seguenti definiscono le singole funzionalità che un joystick potrebbe avere:

Bandiera	Descrizione
JOYCAPS_HASZ	Joystick contiene informazioni sulle coordinate z.
JOYCAPS_HASR	Il joystick ha informazioni sul timone (quarto asse).
JOYCAPS_HASU	Il joystick contiene informazioni sulla coordinata u (quinto asse).
JOYCAPS_HASV	Joystick contiene informazioni sulla coordinata v (sesto asse).
JOYCAPS_HASPOV	Joystick dispone di informazioni sul punto di vista.
JOYCAPS_POV4DIR	Il punto di visualizzazione joystick supporta valori discreti (centrati, avanti, indietro, sinistro e destro).
JOYCAPS_POVCTS	Il punto di visualizzazione joystick supporta i cuscinetti a gradi continui.

wMaxAxes

Numero massimo di assi supportati dal joystick.

wNumAxes

Numero di assi attualmente in uso dal joystick.

wMaxButtons

Numero massimo di pulsanti supportati dal joystick.

szRegKey[MAXPNAMELEN]

Stringa con terminazione Null contenente la chiave del Registro di sistema per il joystick.

szOEMVxD[MAX_JOYSTICKOEMVXDNAME]

Stringa con terminazione Null che identifica l'OEM del driver joystick.

Osservazioni

Nota

L'intestazione joystickapi.h definisce JOYCAPS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	joystickapi.h (include Windows.h)

Vedere anche

Joystick

Strutture joystick multimediali

joySetCapture

Condividi tramite