Funzionalità joystick

[La funzionalità associata a questa pagina, joystick, è una funzionalità legacy. È stato sostituito da spazio dei nomi Windows.Gaming.Input. spazio dei nomi Windows.Gaming.Input è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi spazio dei nomi Windows.Gaming.Input anziché joystick, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

I joystick possono supportare il movimento a due o tre assi e fino a quattro pulsanti. I joystick supportano anche diversi intervalli di di movimento e frequenze di polling. L'intervallo di movimento è la distanza che un punto di manipolazione del joystick può spostare dalla posizione di riposo alla posizione più lontana dalla posizione di riposo. La frequenza di polling è l'intervallo di tempo tra le query joystick.

I driver joystick possono supportare uno o due joystick. È possibile determinare il numero di joystick supportati da un driver joystick usando la funzione joyGetNumDevs. Questa funzione restituisce un intero senza segno che contiene il numero di joystick supportati o zero se non è presente alcun supporto per joystick. Il valore restituito non indica il numero di joystick collegati al sistema.

È possibile determinare se un joystick è collegato al sistema usando la funzione joyGetPos. Questa funzione restituisce JOYERR_NOERROR se il dispositivo specificato è collegato. In caso contrario, restituisce JOYERR_UNPLUGGED.

Ogni joystick ha diverse funzionalità disponibili per l'applicazione. È possibile recuperare le funzionalità di un joystick usando la funzione joyGetDevCaps. Questa funzione riempie una struttura JOYCAPS con funzionalità joystick come i valori minimo e massimo per il sistema di coordinate, il numero di pulsanti sul joystick e le frequenze di polling minime e massime.