joySetThreshold function

The joySetThreshold function sets the movement threshold of a joystick.

Syntax

MMRESULT joySetThreshold(
  UINT uJoyID,
  UINT uThreshold
);

Parameters

uJoyID

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

uThreshold

New movement threshold.

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.
JOYERR_PARMS
The specified joystick device identifier uJoyID is invalid.

Remarks

The movement threshold is the distance the joystick must be moved before a joystick position-change message (MM_JOY1MOVE, MM_JOY1ZMOVE, MM_JOY2MOVE, or MM_JOY2ZMOVE) is sent to a window that has captured the device. The threshold is initially zero.

Requirements

   
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

See Also

Joysticks

Multimedia Joystick Functions