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

[mirror_edk2.git] / MdePkg / Library / UefiUsbLib / UsbDxeLib.c

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