modify coding style to pass ecc tool and provide comments that complied with Doxgen.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5430 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
eric_tian 2008-07-09 01:52:13 +00:00
parent ab6495eacf
commit cbc1082c98
3 changed files with 100 additions and 109 deletions

View File

@ -17,10 +17,10 @@
/** /**
Get Hid Descriptor Get Hid Descriptor.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param InterfaceNum Hid interface number @param InterfaceNum Hid interface number.
@param HidDescriptor Caller allocated buffer to store Usb hid descriptor if @param HidDescriptor Caller allocated buffer to store Usb hid descriptor if
successfully returned. successfully returned.
@ -63,12 +63,9 @@ UsbGetHidDescriptor (
return Result; return Result;
} }
//
// Function to get Report Class descriptor
//
/** /**
get Report Class descriptor Get Report Class descriptor.
@param UsbIo EFI_USB_IO_PROTOCOL. @param UsbIo EFI_USB_IO_PROTOCOL.
@param InterfaceNum Report interface number. @param InterfaceNum Report interface number.
@ -118,15 +115,12 @@ UsbGetReportDescriptor (
return Result; return Result;
} }
//
// Following are HID class request
//
/** /**
Get Hid Protocol Request Get Hid Protocol Request.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Interface Which interface the caller wants to get protocol @param Interface Which interface the caller wants to get protocol.
@param Protocol Protocol value returned. @param Protocol Protocol value returned.
@return EFI_SUCCESS @return EFI_SUCCESS
@ -174,12 +168,11 @@ UsbGetProtocolRequest (
} }
/** /**
Set Hid Protocol Request Set Hid Protocol Request.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Interface Which interface the caller wants to set protocol @param Interface Which interface the caller wants to set protocol.
@param Protocol Protocol value the caller wants to set. @param Protocol Protocol value the caller wants to set.
@return EFI_SUCCESS @return EFI_SUCCESS
@ -226,11 +219,10 @@ UsbSetProtocolRequest (
} }
/** /**
Set Idel request. Set Idel request.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Interface Which interface the caller wants to set. @param Interface Which interface the caller wants to set.
@param ReportId Which report the caller wants to set. @param ReportId Which report the caller wants to set.
@param Duration Idle rate the caller wants to set. @param Duration Idle rate the caller wants to set.
@ -283,7 +275,7 @@ UsbSetIdleRequest (
/** /**
Get Idel request. Get Idel request.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Interface Which interface the caller wants to get. @param Interface Which interface the caller wants to get.
@param ReportId Which report the caller wants to get. @param ReportId Which report the caller wants to get.
@param Duration Idle rate the caller wants to get. @param Duration Idle rate the caller wants to get.
@ -334,11 +326,10 @@ UsbGetIdleRequest (
} }
/** /**
Hid Set Report request. Hid Set Report request.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Interface Which interface the caller wants to set. @param Interface Which interface the caller wants to set.
@param ReportId Which report the caller wants to set. @param ReportId Which report the caller wants to set.
@param ReportType Type of report. @param ReportType Type of report.
@ -396,7 +387,7 @@ UsbSetReportRequest (
/** /**
Hid Set Report request. Hid Set Report request.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Interface Which interface the caller wants to set. @param Interface Which interface the caller wants to set.
@param ReportId Which report the caller wants to set. @param ReportId Which report the caller wants to set.
@param ReportType Type of report. @param ReportType Type of report.

View File

@ -1,4 +1,5 @@
/**@file /** @file
Common header file shared by all source files. Common header file shared by all source files.
This file includes package header files, library classes and protocol, PPI & GUID definitions. This file includes package header files, library classes and protocol, PPI & GUID definitions.

View File

@ -20,18 +20,18 @@
/** /**
Usb Get Descriptor Usb Get Descriptor.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Value Device Request Value @param Value Device Request Value.
@param Index Device Request Index @param Index Device Request Index.
@param DescriptorLength Descriptor Length @param DescriptorLength Descriptor Length.
@param Descriptor Descriptor buffer to contain result @param Descriptor Descriptor buffer to contain result.
@param Status Transfer Status @param Status Transfer Status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -72,18 +72,18 @@ UsbGetDescriptor (
/** /**
Usb Set Descriptor Usb Set Descriptor.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Value Device Request Value @param Value Device Request Value.
@param Index Device Request Index @param Index Device Request Index.
@param DescriptorLength Descriptor Length @param DescriptorLength Descriptor Length.
@param Descriptor Descriptor buffer to set @param Descriptor Descriptor buffer to set.
@param Status Transfer Status @param Status Transfer Status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -124,16 +124,16 @@ UsbSetDescriptor (
/** /**
Usb Get Device Interface Usb Get Device Interface.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Index Interface index value @param Index Interface index value.
@param AltSetting Alternate setting @param AltSetting Alternate setting.
@param Status Trasnsfer status @param Status Trasnsfer status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -171,16 +171,16 @@ UsbGetInterface (
/** /**
Usb Set Device Interface Usb Set Device Interface.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param InterfaceNo Interface Number @param InterfaceNo Interface Number.
@param AltSetting Alternate setting @param AltSetting Alternate setting.
@param Status Trasnsfer status @param Status Trasnsfer status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -219,15 +219,15 @@ UsbSetInterface (
/** /**
Usb Get Device Configuration Usb Get Device Configuration.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param ConfigValue Config Value @param ConfigValue Config Value.
@param Status Transfer Status @param Status Transfer Status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -263,15 +263,15 @@ UsbGetConfiguration (
/** /**
Usb Set Device Configuration Usb Set Device Configuration.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Value Configuration Value to set @param Value Configuration Value to set.
@param Status Transfer status @param Status Transfer status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -307,17 +307,17 @@ UsbSetConfiguration (
/** /**
Usb Set Device Feature Usb Set Device Feature.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Recipient Interface/Device/Endpoint @param Recipient Interface/Device/Endpoint.
@param Value Request value @param Value Request value.
@param Target Request Index @param Target Request Index.
@param Status Transfer status @param Status Transfer status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -373,17 +373,17 @@ UsbSetFeature (
/** /**
Usb Clear Device Feature Usb Clear Device Feature.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Recipient Interface/Device/Endpoint @param Recipient Interface/Device/Endpoint.
@param Value Request value @param Value Request value.
@param Target Request Index @param Target Request Index.
@param Status Transfer status @param Status Transfer status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -439,17 +439,17 @@ UsbClearFeature (
/** /**
Usb Get Device Status Usb Get Device Status.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param Recipient Interface/Device/Endpoint @param Recipient Interface/Device/Endpoint.
@param Target Request index @param Target Request index.
@param DevStatus Device status @param DevStatus Device status.
@param Status Transfer status @param Status Transfer status.
@retval EFI_INVALID_PARAMETER Parameter is error @retval EFI_INVALID_PARAMETER Parameter is error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
@retval EFI_TIMEOUT Device has no response @retval EFI_TIMEOUT Device has no response.
**/ **/
EFI_STATUS EFI_STATUS
@ -504,17 +504,16 @@ UsbGetStatus (
} }
/** /**
Clear endpoint stall Clear endpoint stall.
@param UsbIo EFI_USB_IO_PROTOCOL @param UsbIo EFI_USB_IO_PROTOCOL.
@param EndpointNo Endpoint Number @param EndpointNo Endpoint Number.
@param Status Transfer Status @param Status Transfer Status.
@retval EFI_NOT_FOUND Can't find the Endpoint @retval EFI_NOT_FOUND Can't find the Endpoint.
@retval EFI_DEVICE_ERROR Hardware error @retval EFI_DEVICE_ERROR Hardware error.
@retval EFI_SUCCESS Success @retval EFI_SUCCESS Success.
**/ **/
EFI_STATUS EFI_STATUS