Add function to return the length of the HID Report

lib_xua/src/hid/hid_report_descriptor.c

@@ -130,6 +130,11 @@ size_t hidGetReportDescriptorLength( void )
     return ( hidReportDescriptorPrepared ) ? hidReportDescriptorLength : 0;
 }
 
+size_t hidGetReportLength( void )
+{
+    return ( hidReportDescriptorPrepared ) ? HID_REPORT_LENGTH : 0;
+}
+
 void hidPrepareReportDescriptor( void )
 {
     if( !hidReportDescriptorPrepared ) {

lib_xua/src/hid/xua_hid_report_descriptor.h

@@ -6,6 +6,10 @@
  *
  * This file defines the structure of the HID Report descriptor and decalres
  *   functions for manipulating it.
+ * Because the Report descriptor defines the length of the HID Report, this file
+ *   declares a function for obtaining the Report length as well.
+ * The using application has the responsibility to define the report descriptor
+ *   structure and default contents in their hid_report_descriptor.h file.
  * Document section numbers refer to the HID Device Class Definition, version 1.11.
  */
 
@@ -82,6 +86,17 @@ unsigned char* hidGetReportDescriptor( void );
  */
 size_t hidGetReportDescriptorLength( void );
 
+/**
+ * @brief Get the length of the HID Report
+ *
+ * This function returns the length of the USB HID Report.
+ * It returns zero if the Report descriptor has not been prepared,
+ *   i.e., no one has called \c hidPrepareReportDescriptor().
+ *
+ * @return The length of the Report in bytes
+ */
+size_t hidGetReportLength( void );
+
 /**
  * @brief Prepare the USB HID Report descriptor
  *