This is new wiki software and old wiki content. It's a work in progress!
Here's the explanation.
Be gentle, report bugs, leave feedback on pages, or just edit them yourself! Thanks!

SDL Wiki

SDL_hid_read_timeout

Read an Input report from a HID device with timeout.

Syntax

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

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.

milliseconds

timeout in milliseconds or -1 for blocking wait.

Return Value

Returns the actual number of bytes read and -1 on error. If no packet was available to be read within the timeout period, 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 2.0.18.


CategoryAPI


[ edit | delete | history | feedback | raw ]

[ 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.