SDL_hid_read(3)

SDL_hid_read3

Read an input report from a hid device.

Usage

#include "SDL3/SDL.h"

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

Header file

Defined in SDL3/SDL_hidapi.h

Overview

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.

Function parameters

dev

a device handle returned from SDL_hid_open ().

data

a buffer to put the read data into.

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

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.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.