(This is the legacy documentation for SDL2, the previous stable version; SDL3 is the current stable version.)

SDL_HapticOpenFromJoystick

Open a haptic device for use from a joystick device.

Header File

Syntax

SDL_Haptic* SDL_HapticOpenFromJoystick(SDL_Joystick *
                                       joystick);

Function Parameters

SDL_Joystick *

joystick

the SDL_Joystick to create a haptic device from.

Return Value

(SDL_Haptic *) Returns a valid haptic device identifier on success or NULL on failure; call SDL_GetError() for more information.

Remarks

You must still close the haptic device separately. It will not be closed with the joystick.

When opened from a joystick you should first close the haptic device before closing the joystick device. If not, on some implementations the haptic device will also get unallocated and you'll be unable to use force feedback on that device.

Version

This function is available since SDL 2.0.0.