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

SDL_hid_enumerate

Enumerate the HID Devices.

Header File

Syntax

SDL_hid_device_info * SDL_hid_enumerate(unsigned short vendor_id, unsigned short product_id);

Function Parameters

unsigned short	vendor_id	The Vendor ID (VID) of the types of device to open.
unsigned short	product_id	The Product ID (PID) of the types of device to open.

Return Value

(SDL_hid_device_info *) Returns a pointer to a linked list of type SDL_hid_device_info, containing information about the HID devices attached to the system, or NULL in the case of failure. Free this linked list by calling SDL_hid_free_enumeration().

Remarks

This function returns a linked list of all the HID devices attached to the system which match vendor_id and product_id. If vendor_id is set to 0 then any vendor matches. If product_id is set to 0 then any product matches. If vendor_id and product_id are both set to 0, then all HID devices will be returned.

Version

This function is available since SDL 2.0.18.