joyGetPos function
The joyGetPos function queries a joystick for its position and button status.
Syntax
MMRESULT joyGetPos(
UINT uJoyID,
LPJOYINFO pji
);
Parameters
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.
Return value
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. |
Remarks
For devices that have four to six axes of movement, a point-of-view control, or more than four buttons, use the joyGetPosEx function.
Requirements
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
Mmsystem.h (include Windows.h) |
Library |
Winmm.lib |
DLL |
Winmm.dll |