Struttura JOYINFOEX (joystickapi.h)
La struttura JOYINFOEX contiene informazioni estese sulla posizione del joystick, sulla posizione del punto di vista e sullo stato del pulsante.
Sintassi
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;
Members
dwSize
Dimensioni, in byte, di questa struttura.
dwFlags
Flag che indicano le informazioni valide restituite in questa struttura. I membri che non contengono informazioni valide sono impostati su zero. Vengono definiti i flag seguenti:
| Flag | Descrizione |
|---|---|
| JOY_RETURNALL | Equivale a impostare tutti i bit di JOY_RETURN ad eccezione di JOY_RETURNRAWDATA. |
| JOY_RETURNBUTTONS | Il membro dwButtons contiene informazioni valide sullo stato di ogni pulsante joystick. |
| JOY_RETURNCENTERED | Centra la posizione neutrale del joystick al valore medio di ogni asse di movimento. |
| JOY_RETURNPOV | Il membro dwPOV contiene informazioni valide sul controllo point-of-view, espresso in unità discrete. |
| JOY_RETURNPOVCTS | Il membro dwPOV contiene informazioni valide sul controllo point-of-view espresso in unità continue di centesimo grado. |
| JOY_RETURNR | Il membro dwRpos contiene dati validi sul pedale del timone. Queste informazioni rappresentano un altro asse (quarto). |
| JOY_RETURNRAWDATA | I dati archiviati in questa struttura sono letture di joystick nonlibrate. |
| JOY_RETURNU | Il membro dwUpos contiene dati validi per un quinto asse del joystick, se tale asse è disponibile o restituisce zero in caso contrario. |
| JOY_RETURNV | Il membro dwVpos contiene dati validi per un sesto asse del joystick, se tale asse è disponibile o restituisce zero in caso contrario. |
| JOY_RETURNX | Il membro dwXpos contiene dati validi per la coordinata x del joystick. |
| JOY_RETURNY | Il membro dwYpos contiene dati validi per la coordinata y del joystick. |
| JOY_RETURNZ | Il membro dwZpos contiene dati validi per la coordinata z del joystick. |
I flag seguenti forniscono dati per calibrare un joystick e sono destinati ad applicazioni di calibrazione personalizzate.
| Flag | Descrizione |
|---|---|
| JOY_CAL_READ3 | Leggere le coordinate x,y e z e archiviare i valori non elaborati in dwXpos, dwYpos e dwZpos. |
| JOY_CAL_READ4 | Leggere le informazioni sul timone e le coordinate x,y e z e archiviare i valori non elaborati in dwXpos, dwYpos, dwZpos e dwRpos. |
| JOY_CAL_READ5 | Leggere le informazioni sul timone e le coordinate x,y, z-e you-e archiviare i valori non elaborati in dwXpos, dwYpos, dwZpos, dwRpos e dwUpos. |
| JOY_CAL_READ6 | Leggere i dati dell'asse v non elaborati se è presente un mini driver joystick che fornirà i dati. Restituisce zero in caso contrario. |
| JOY_CAL_READALWAYS | Leggere la porta joystick anche se il driver non rileva un dispositivo. |
| JOY_CAL_READRONLY | Leggere le informazioni sul timone se è presente un mini-driver joystick che fornirà i dati e archivierà il valore non elaborato in dwRpos. Restituisce zero in caso contrario. |
| JOY_CAL_READXONLY | Leggere la coordinata x e archiviare il valore non elaborato (non classificato) in dwXpos. |
| JOY_CAL_READXYONLY | Legge le coordinate x e y e inserisce i valori non elaborati in dwXpos e dwYpos. |
| JOY_CAL_READYONLY | Legge la coordinata y e archivia il valore non elaborato in dwYpos. |
| JOY_CAL_READZONLY | Leggere la coordinata z e archiviare il valore non elaborato in dwZpos. |
| JOY_CAL_READUONLY | Leggere la coordinata u se è presente un mini-driver joystick che fornirà i dati e archivierà il valore non elaborato in dwUpos. Restituisce zero in caso contrario. |
| JOY_CAL_READVONLY | Leggere la coordinata v se è presente un mini-driver joystick che fornirà i dati e archivierà il valore non elaborato in dwVpos. Restituisce zero in caso contrario. |
dwXpos
Coordinata X corrente.
dwYpos
Coordinata Y corrente.
dwZpos
Coordinata Z corrente.
dwRpos
Posizione corrente del timone o del quarto asse del joystick.
dwUpos
Posizione dell'asse quinto corrente.
dwVpos
Posizione corrente del sesto asse.
dwButtons
Stato corrente dei 32 pulsanti joystick. Il valore di questo membro può essere impostato su qualsiasi combinazione di flag JOY_BUTTON n , dove n è un valore compreso nell'intervallo compreso tra 1 e 32 corrispondente al pulsante premuto.
dwButtonNumber
Numero di pulsante corrente premuto.
dwPOV
Posizione corrente del controllo punto di visualizzazione. I valori per questo membro sono compresi nell'intervallo compreso tra 0 e 35.900. Questi valori rappresentano l'angolo, espresso in gradi, di ogni visualizzazione moltiplicato per 100.
dwReserved1
Riservati; non usare.
dwReserved2
Riservati; non usare.
Commenti
Il valore del membro dwSize viene usato anche per identificare il numero di versione per la struttura quando viene passato alla funzione joyGetPosEx .
La maggior parte dei dispositivi con un controllo point-of-view ha solo cinque posizioni. Quando viene impostato il flag di JOY_RETURNPOV, queste posizioni vengono segnalate usando le costanti seguenti:
| Point-Of-View Flag | Descrizione |
|---|---|
| JOY_POVBACKWARD | Il cappello da punto di vista viene premuto all'indietro. Il valore 18.000 rappresenta un orientamento di 180,00 gradi (al retro). |
| JOY_POVCENTERED | Il cappello da punto di vista si trova nella posizione neutra. Il valore -1 indica che il cappello da punto di vista non ha un angolo da segnalare. |
| JOY_POVFORWARD | Il cappello da punto di vista viene premuto in avanti. Il valore 0 rappresenta un orientamento di 0,00 gradi (dritto avanti). |
| JOY_POVLEFT | Il cappello da punto di vista viene premuto a sinistra. Il valore 27.000 rappresenta un orientamento di 270,00 gradi (90,00 gradi a sinistra). |
| JOY_POVRIGHT | Il cappello da punto di vista viene premuto a destra. Il valore 9.000 rappresenta un orientamento di 90,00 gradi (a destra). |
Il driver del joystick predefinito supporta attualmente queste cinque direzioni discrete. Se un'applicazione può accettare solo i valori di visualizzazione definiti, deve usare il flag di JOY_RETURNPOV. Se un'applicazione può accettare altre letture di grado, deve usare il flag di JOY_RETURNPOVCTS per ottenere dati continui se è disponibile. Il flag JOY_RETURNPOVCTS supporta anche le costanti JOY_POV usate con il flag di JOY_RETURNPOV.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | joystickapi.h (include Windows.h) |
Vedi anche
Joystick
Strutture del joystick multimediale