Funzione joyGetPosEx (joystickapi.h)

  • Articolo

La funzione joyGetPosEx esegue una query su un joystick per la posizione e lo stato del pulsante.

Sintassi

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

Parametri

uJoyID

Identificatore del joystick su cui eseguire una query. I valori validi per uJoyID sono compresi tra zero (JOYSTICKID1) e 15.

pji

Puntatore a una struttura JOYINFOEX che contiene informazioni estese sulla posizione e lo stato del pulsante del joystick. È necessario impostare i membri dwSize edwFlags o joyGetPosEx avranno esito negativo. Le informazioni restituite da joyGetPosEx dipendono dai flag specificati in dwFlags.

Valore restituito

Restituisce JOYERR_NOERROR se ha esito positivo o uno dei valori di errore seguenti.

Codice restituito Descrizione
MMSYSERR_NODRIVER
 Il conducente del joystick non è presente.
MMSYSERR_INVALPARAM
 È stato passato un parametro non valido.
MMSYSERR_BADDEVICEID
 L'identificatore del joystick specificato non è valido.
JOYERR_UNPLUGGED
 Il joystick specificato non è connesso al sistema.
JOYERR_PARMS
 L'identificatore del joystick specificato non è valido.

Commenti

Questa funzione consente l'accesso a dispositivi estesi, ad esempio pedali timone, cappelli da punto di vista, dispositivi con un numero elevato di pulsanti e sistemi di coordinate che usano fino a sei assi. Per i dispositivi joystick che usano tre assi o meno e hanno meno di quattro pulsanti, usare la funzione joyGetPos .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione joystickapi.h (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Joystick

Funzioni joystick multimediali