joyGetPos function (joystickapi.h)

The joyGetPos function queries a joystick for its position and button status.

Syntax

MMRESULT joyGetPos(
  UINT      uJoyID,
  LPJOYINFO pji
);

uJoyID

Identifier of the joystick to be queried. Valid values for uJoyID range from zero (JOYSTICKID1) to 15.

pji

Pointer to a JOYINFO structure that contains the position and button status of the joystick.

Returns JOYERR_NOERROR if successful or one of the following error values.

Return code	Description
MMSYSERR_NODRIVER	The joystick driver is not present.
MMSYSERR_INVALPARAM	An invalid parameter was passed.
JOYERR_UNPLUGGED	The specified joystick is not connected to the system.

For devices that have four to six axes of movement, a point-of-view control, or more than four buttons, use the joyGetPosEx function.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	joystickapi.h (include Windows.h)
Library	Winmm.lib
DLL	Winmm.dll