HIDGetReport

Syntax

#include <cafe/hid.h>
    
HID_ERROR_CODE  HIDGetReport(
                                    u32         handle,
                                    u8          report_type,
                                    u8          report_id,
                                    u8          *p_buffer,
                                    u32         buffer_length,
                                    HIDCallback async_callback,
                                    void        *p_user
                                    );

Parameters

handle Handle associated with the HID device.
report_type Report type as defined by HID specification.
report_id Report ID as defined by HID specification.
p_buffer Pointer to buffer to receive transaction data. This buffer must be aligned and padded to L2_CACHE_LINE_SIZE.
buffer_length Size of the buffer to receive transaction data in bytes.
async_callback Pointer to HIDCallback for asynchronous completion notification.
p_user User-specified pointer passed to HIDCallback.

Return Values

HIDGetReport returns HID_ERROR_CODE. For blocking calls, a return value of ≥ 0 specifies the number of bytes transferred for the request. For asynchronous calls, a return value of HID_ERROR_OK specifies that the call was initiated successfully and the result of the transaction will be specified in the HIDCallback parameters upon completion.

Description

HIDGetReport performs an HID get report transaction to an HID interface associated with an HIDDevice.handle. HIDGetReport executes in a blocking manner when no HIDCallback is specified.

Do Not Call From

Background Do not call this function from the background.

See Also

HID_ERROR_CODE
HIDCallback
HIDSetReport

Revision History

2013/05/08 Automated cleanup pass.
2011/09/29 Initial version.


CONFIDENTIAL