(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_hid_read

Read an Input report from a HID device.

Header File

Defined in <SDL3/SDL_hidapi.h>

Syntax

int SDL_hid_read(SDL_hid_device *dev, unsigned char *data, size_t length);

Function Parameters

SDL_hid_device *	dev	a device handle returned from SDL_hid_open().
unsigned char *	data	a buffer to put the read data into.
size_t	length	the number of bytes to read. For devices with multiple reports, make sure to read an extra byte for the report number.

Return Value

(int) Returns the actual number of bytes read and -1 on failure; call SDL_GetError() for more information. If no packet was available to be read and the handle is in non-blocking mode, this function returns 0.

Remarks

Input reports are returned to the host through the INTERRUPT IN endpoint. The first byte will contain the Report number if the device uses numbered reports.

Version

This function is available since SDL 3.1.3.

---

CategoryAPI, CategoryAPIFunction, CategoryHIDAPI

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.