joyReleaseCapture

The joyReleaseCapture function releases the specified captured joystick.

MMRESULT joyReleaseCapture(
  UINT uJoyID  
);

Parameters

uJoyID

Identifier of the joystick to be released. Valid values for uJoyID range from zero (JOYSTICKID1) to 15, except for Windows NT 4.0. For Windows NT 4.0, valid values are limited to JOYSTICKID1 and JOYSTICKID2.

Return Values

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

Value Description
MMSYSERR_NODRIVER The joystick driver is not present.
MMSYSERR_INVALIDPARAM Windows 95/98/Me: The specified joystick device identifier uJoyID is invalid.
JOYERR_PARMS Windows NT/2000/XP: The specified joystick device identifier uJoyID is invalid.

Remarks

This method returns JOYERR_NOERROR when passed a valid joystick identifier that has not been captured.

Requirements

  Windows NT/2000/XP: Included in Windows NT 3.1 and later.
  Windows 95/98/Me: Included in Windows 95 and later.
  Header: Declared in Mmsystem.h; include Windows.h.
  Library: Use Winmm.lib.

See Also

Joysticks, Multimedia Joystick Functions

Show: