plucky (3) SDL_hid_get_feature_report.3.gz

Provided by: libsdl3-doc_3.2.4+ds-2_all bug

NAME

       SDL_hid_get_feature_report - Get a feature report from a HID device.

HEADER FILE

       Defined in SDL3/SDL_hidapi.h

SYNOPSIS

       #include "SDL3/SDL.h"

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

DESCRIPTION

       Set  the first byte of data to the Report ID of the report to be read.  Make sure to allow space for this
       extra byte in data . Upon return, the first byte will still contain the Report ID, and  the  report  data
       will start in data[1].

FUNCTION PARAMETERS

       dev    a device handle returned from SDL_hid_open ().

       data   a  buffer  to  put  the read data into, including the Report ID. Set the first byte of data to the
              Report ID of the report to be read, or set it to  zero  if  your  device  does  not  use  numbered
              reports.

       length the  number  of bytes to read, including an extra byte for the report ID. The buffer can be longer
              than the actual report.

RETURN VALUE

       Returns the number of bytes read plus one for the report ID (which is still in the first byte), or -1  on
       on failure; call

       SDL_GetError () for more information.

AVAILABILITY

       This function is available since SDL 3.2.0.