Export (0) Print
Expand All
Expand Minimize
0 out of 2 rated this helpful - Rate this topic

joyGetPosEx function

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

Syntax


MMRESULT joyGetPosEx(
  UINT uJoyID,
  LPJOYINFOEX pji
);

Parameters

uJoyID

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

pji

Pointer to a JOYINFOEX structure that contains extended position information and button status of the joystick. You must set the dwSize and dwFlags members or joyGetPosEx will fail. The information returned from joyGetPosEx depends on the flags you specify in dwFlags.

Return value

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

Return codeDescription
MMSYSERR_NODRIVER

The joystick driver is not present.

MMSYSERR_INVALPARAM

An invalid parameter was passed.

MMSYSERR_BADDEVICEID

The specified joystick identifier is invalid.

JOYERR_UNPLUGGED

The specified joystick is not connected to the system.

JOYERR_PARMS

The specified joystick identifier is invalid.

 

Remarks

This function provides access to extended devices such as rudder pedals, point-of-view hats, devices with a large number of buttons, and coordinate systems using up to six axes. For joystick devices that use three axes or fewer and have fewer than four buttons, use the joyGetPos 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

See also

Joysticks
Multimedia Joystick Functions

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.