DIJOYSTATE

The DIJOYSTATE type contains information about the state of a joystick device. (This term includes other controllers such as game pads and steering wheels). This type is used with the DirectInputDevice.GetDeviceStateJoystick method.

Type DIJOYSTATE
    buttons(0 To 31) As Byte
    POV(0 To 3) As Long
    rx As Long
    ry As Long
    rz As Long
    slider(0 To 1) As Long
    x As Long
    y As Long
    z As Long
End Type

Members

buttons

Array of button states. The high-order bit of the byte is set if the corresponding button is down and clear if the button is up or does not exist.

POV

The current position of up to four direction controllers (such as point-of-view hats). The position is indicated in hundredths of degrees clockwise from north (away from the user). The center position is normally reported as -1; but see Remarks. For indicators that have only five positions, the value for a controller will be -1, 0, 9,000, 18,000, or 27,000.

rx

Information about the joystick x-axis rotation. If the joystick does not have this, the value is 0.

ry

Information about the joystick y-axis rotation. If the joystick does not have this axis, the value is 0.

rz

Information about the joystick z-axis rotation (often called the rudder). If the joystick does not have this axis, the value is 0.

slider

Two additional axis values whose semantics depend on the joystick. Use the DirectInputDevice.GetObjectInfo method to obtain semantic information about these values.

x

Information about the joystick x-axis (usually the left-right movement of a stick).

y

Information about the joystick y-axis (usually the forward-backward movement of a stick).

z

Information about the joystick z-axis (often the throttle control). If the joystick does not have this axis, the value is zero.

Remarks

You must prepare the device for joystick-style access by calling the DirectInputDevice.SetCommonDataFormat method, passing the DIFORMAT_JOYSTICK format constant.

If an axis is in relative mode, then the appropriate member contains the change in position. If it is in absolute mode, then the member contains the absolute axis position.

Some drivers report the centered position of the POV indicator as 65,535. You can determine whether an indicator is centered as follows:

Dim POVCentered as Boolean
POVCentered = MyDijoystate.POV(0) And &HFFFF;

See Also

DIJOYSTATE2