Split out the RFCOMM Control Channel command processing code into a seperate set...
[pub/USBasp.git] / LUFA / Drivers / USB / Class / Host / HID.h
index 7aabd7c..1988e5d 100644 (file)
@@ -71,7 +71,7 @@
 
        /* Public Interface - May be used in end-application: */
                /* Macros: */
-                       /** Error code for some HID Host functions, indicating a logical (and not hardware) error */
+                       /** Error code for some HID Host functions, indicating a logical (and not hardware) error. */
                        #define HID_ERROR_LOGICAL              0x80
        
                /* Type Defines: */
                                const struct
                                {
                                        uint8_t  DataINPipeNumber; /**< Pipe number of the HID interface's IN data pipe */
-                                       bool     DataINPipeDoubleBank; /** Indicates if the HID interface's IN data pipe should use double banking */
+                                       bool     DataINPipeDoubleBank; /**< Indicates if the HID interface's IN data pipe should use double banking */
 
                                        uint8_t  DataOUTPipeNumber; /**< Pipe number of the HID interface's OUT data pipe */
-                                       bool     DataOUTPipeDoubleBank; /** Indicates if the HID interface's OUT data pipe should use double banking */
+                                       bool     DataOUTPipeDoubleBank; /**< Indicates if the HID interface's OUT data pipe should use double banking */
 
                                        uint8_t  HIDInterfaceProtocol; /**< HID interface protocol value to match against if a specific
                                                                        *   boot subclass protocol is required, either \ref HID_BOOT_MOUSE_PROTOCOL,
                         *  \note Once the device pipes are configured, the HID device's reporting protocol <b>must</b> be set via a call
                         *        to either the \ref HID_Host_SetBootProtocol() or \ref HID_Host_SetReportProtocol() function.
                         *
-                        *  \param[in,out] HIDInterfaceInfo  Pointer to a structure containing a HID Class host configuration and state
-                        *  \param[in] ConfigDescriptorSize  Length of the attached device's Configuration Descriptor
-                        *  \param[in] DeviceConfigDescriptor  Pointer to a buffer containing the attached device's Configuration Descriptor
+                        *  \param[in,out] HIDInterfaceInfo        Pointer to a structure containing a HID Class host configuration and state
+                        *  \param[in]     ConfigDescriptorSize    Length of the attached device's Configuration Descriptor
+                        *  \param[in]     DeviceConfigDescriptor  Pointer to a buffer containing the attached device's Configuration Descriptor
                         *
                         *  \return A value from the \ref HIDHost_EnumerationFailure_ErrorCodes_t enum
                         */
                         *        can generate.
                         *
                         *  \param[in,out] HIDInterfaceInfo  Pointer to a structure containing a HID Class host configuration and state
-                        *  \param[in] Buffer  Buffer to store the received report into
+                        *  \param[in]     Buffer            Buffer to store the received report into
                         *
                         *  \return An error code from the \ref Pipe_Stream_RW_ErrorCodes_t enum
                         */
                         *  \note When the HID_HOST_BOOT_PROTOCOL_ONLY compile time token is defined, this method is unavailable.
                         *
                         *  \param[in,out] HIDInterfaceInfo  Pointer to a structure containing a HID Class host configuration and state
-                        *  \param[in] ReportID  Report ID of the received report if ControlRequest is false, set by the to the Report ID to fetch
-                        *  \param[in] Buffer  Buffer to store the received report into
+                        *  \param[in]     ReportID          Report ID of the received report if ControlRequest is false, set by the to the Report ID to fetch
+                        *  \param[in]     Buffer            Buffer to store the received report into
                         *
                         *  \return A value from the \ref USB_Host_SendControlErrorCodes_t enum
                         */
                         *        from the parameter list of this function.
                         *
                         *  \param[in,out] HIDInterfaceInfo  Pointer to a structure containing a HID Class host configuration and state
-                        *  \param[in] ReportID  Report ID of the report to send to the device, or 0 if the device does not use report IDs
-                        *  \param[in] ReportType  Type of report to issue to the device, either \ref REPORT_ITEM_TYPE_Out or \ref REPORT_ITEM_TYPE_Feature
-                        *  \param[in] Buffer  Buffer containing the report to send to the attached device
-                        *  \param[in] ReportSize  Report size in bytes to send to the attached device
+                        *  \param[in]     ReportID          Report ID of the report to send to the device, or 0 if the device does not use report IDs
+                        *  \param[in]     ReportType        Type of report to issue to the device, either \ref REPORT_ITEM_TYPE_Out or \ref REPORT_ITEM_TYPE_Feature
+                        *  \param[in]     Buffer            Buffer containing the report to send to the attached device
+                        *  \param[in]     ReportSize        Report size in bytes to send to the attached device
                         *
                         *  \return An error code from the \ref USB_Host_SendControlErrorCodes_t enum if the DeviceUsesOUTPipe flag is set in
                         *          the interface's state structure, a value from the \ref Pipe_Stream_RW_ErrorCodes_t enum otherwise