devela::_dep::sdl3::sys::haptic

Function SDL_OpenHapticFromJoystick

pub unsafe extern "C" fn SDL_OpenHapticFromJoystick(
    joystick: *mut SDL_Joystick,
) -> *mut SDL_Haptic
Available on crate feature dep_sdl3 only.
Expand description

Open a haptic device for use from a joystick device.

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.

§Parameters

  • joystick: the SDL_Joystick to create a haptic device from.

§Return value

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

§Availability

This function is available since SDL 3.2.0.

§See also