ControllerImage_GetDeviceType

Get the device type for a ControllerImage_Device object.

Header File

Defined in <controllerimage.h>

Syntax

const char * ControllerImage_GetDeviceType(ControllerImage_Device *device);

Function Parameters

Return Value

(const char *) Returns a NULL-terminated ASCII string, or NULL on error; call SDL_GetError() for details.

Remarks

Device types are short, ASCII strings that describe the controller. The strings are derived from the artset name, not anything that SDL produces.

Some examples strings this function might return are "xbox360", "ps5", "joyconpair", "ouya".

Generally speaking, this is not intended to be used to identify controllers; SDL3 has more robust facilities for this task, and this might be giving a best guess to controller type anyhow. All this tells you is what artset was chosen.

Thread Safety

This function is not thread safe.

Version

This function is available since ControllerImage 1.0.0.

CategoryAPI, CategoryAPIFunction, CategoryControllerImage