]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdeModulePkg/Include/Ppi/UsbIo.h
UefiCpuPkg: Move AsmRelocateApLoopStart from Mpfuncs.nasm to AmdSev.nasm
[mirror_edk2.git] / MdeModulePkg / Include / Ppi / UsbIo.h
index b024d4640a090cfe80089a6f1e4270a7db33ade6..a7122f31edd471fbcc40c7e1110e8fcba1c57708 100644 (file)
@@ -1,21 +1,14 @@
 /** @file\r
-  Defines the PEI_USB_IO_PPI that the USB-related PEIM can use for I/O operations \r
-  on the USB BUS.  This interface enables recovery from a \r
-  USB-class storage device, such as USB CD/DVD, USB hard drive, or USB FLASH \r
+  Defines the PEI_USB_IO_PPI that the USB-related PEIM can use for I/O operations\r
+  on the USB BUS.  This interface enables recovery from a\r
+  USB-class storage device, such as USB CD/DVD, USB hard drive, or USB FLASH\r
   drive.  These interfaces are modeled on the UEFI 2.3 specification EFI_USB_IO_PROTOCOL.\r
-  Refer to section 16.2.4 of the UEFI 2.3 Specification for more information on \r
+  Refer to section 16.2.4 of the UEFI 2.3 Specification for more information on\r
   these interfaces.\r
 \r
-Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
 \r
-This program and the accompanying materials\r
-are licensed and made available under the terms and conditions\r
-of the BSD License which accompanies this distribution.  The\r
-full text of the license may be found at\r
-http://opensource.org/licenses/bsd-license.php\r
-\r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
 **/\r
 \r
@@ -35,36 +28,36 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 ///\r
 /// Forward declaration for the PEI_USB_IO_PPI.\r
 ///\r
-typedef struct _PEI_USB_IO_PPI  PEI_USB_IO_PPI;\r
+typedef struct _PEI_USB_IO_PPI PEI_USB_IO_PPI;\r
 \r
 /**\r
   Submits control transfer to a target USB device.\r
 \r
   @param[in]     PeiServices   The pointer to the PEI Services Table.\r
   @param[in]     This          The pointer to this instance of the PEI_USB_IO_PPI.\r
-  @param[in]     Request       A pointer to the USB device request that will be \r
+  @param[in]     Request       A pointer to the USB device request that will be\r
                                sent to the USB device.\r
-  @param[in]     Direction     Specifies the data direction for the transfer. There \r
-                               are three values available: \r
+  @param[in]     Direction     Specifies the data direction for the transfer. There\r
+                               are three values available:\r
                                EfiUsbDataIn, EfiUsbDataOut and EfiUsbNoData.\r
-  @param[in]     Timeout       Indicates the maximum time, in milliseconds, that \r
+  @param[in]     Timeout       Indicates the maximum time, in milliseconds, that\r
                                the transfer is allowed to complete.\r
                                If Timeout is 0, then the caller must wait for the\r
                                function to be completed until EFI_SUCCESS or\r
                                EFI_DEVICE_ERROR is returned.\r
-  @param[in,out] Data          A pointer to the buffer of data that will be \r
+  @param[in,out] Data          A pointer to the buffer of data that will be\r
                                transmitted to or received from the USB device.\r
-  @param[in]     DataLength    On input, indicates the size, in bytes, of the data \r
+  @param[in]     DataLength    On input, indicates the size, in bytes, of the data\r
                                buffer specified by Data.\r
-                               \r
+\r
   @retval EFI_SUCCESS             The control transfer was completed successfully.\r
   @retval EFI_INVALID_PARAMETER   Some parameters are invalid.\r
-  @retval EFI_OUT_OF_RESOURCES    The control transfer could not be completed due \r
+  @retval EFI_OUT_OF_RESOURCES    The control transfer could not be completed due\r
                                   to a lack of resources.\r
   @retval EFI_TIMEOUT             The control transfer failed due to timeout.\r
-  @retval EFI_DEVICE_ERROR        The control transfer failed due to host controller \r
+  @retval EFI_DEVICE_ERROR        The control transfer failed due to host controller\r
                                   or device error.\r
-                                  Caller should check TransferResult for detailed \r
+                                  Caller should check TransferResult for detailed\r
                                   error information.\r
 \r
 **/\r
@@ -95,12 +88,12 @@ EFI_STATUS
 \r
   @retval EFI_SUCCESS             The bulk transfer completed successfully.\r
   @retval EFI_INVALID_PARAMETER   Some parameters are invalid.\r
-  @retval EFI_OUT_OF_RESOURCES    The bulk transfer could not be completed due to \r
+  @retval EFI_OUT_OF_RESOURCES    The bulk transfer could not be completed due to\r
                                   a lack of resources.\r
   @retval EFI_TIMEOUT             The bulk transfer failed due to timeout.\r
-  @retval EFI_DEVICE_ERROR        The bulk transfer failed due to host controller \r
+  @retval EFI_DEVICE_ERROR        The bulk transfer failed due to host controller\r
                                   or device error.\r
-                                  Caller should check TransferResult for detailed \r
+                                  Caller should check TransferResult for detailed\r
                                   error information.\r
 \r
 **/\r
@@ -124,7 +117,7 @@ EFI_STATUS
 \r
   @retval EFI_SUCCESS             The interface descriptor was returned.\r
   @retval EFI_INVALID_PARAMETER   Some parameters are invalid.\r
-  @retval EFI_DEVICE_ERROR        A device error occurred, the function failed to \r
+  @retval EFI_DEVICE_ERROR        A device error occurred, the function failed to\r
                                   get the interface descriptor.\r
 \r
 **/\r
@@ -146,7 +139,7 @@ EFI_STATUS
 \r
   @retval EFI_SUCCESS             The endpoint descriptor was returned.\r
   @retval EFI_INVALID_PARAMETER   Some parameters are invalid.\r
-  @retval EFI_DEVICE_ERROR        A device error occurred, the function failed to \r
+  @retval EFI_DEVICE_ERROR        A device error occurred, the function failed to\r
                                   get the endpoint descriptor.\r
 \r
 **/\r
@@ -180,17 +173,17 @@ EFI_STATUS
 ///\r
 /// This PPI contains a set of services to interact with the USB host controller.\r
 /// These interfaces are modeled on the UEFI 2.3 specification EFI_USB_IO_PROTOCOL.\r
-/// Refer to section 16.2.4 of the UEFI 2.3 Specification for more information on \r
+/// Refer to section 16.2.4 of the UEFI 2.3 Specification for more information on\r
 /// these interfaces.\r
 ///\r
 struct _PEI_USB_IO_PPI {\r
-  PEI_USB_CONTROL_TRANSFER          UsbControlTransfer;\r
-  PEI_USB_BULK_TRANSFER             UsbBulkTransfer;\r
-  PEI_USB_GET_INTERFACE_DESCRIPTOR  UsbGetInterfaceDescriptor;\r
-  PEI_USB_GET_ENDPOINT_DESCRIPTOR   UsbGetEndpointDescriptor;\r
-  PEI_USB_PORT_RESET                UsbPortReset;\r
+  PEI_USB_CONTROL_TRANSFER            UsbControlTransfer;\r
+  PEI_USB_BULK_TRANSFER               UsbBulkTransfer;\r
+  PEI_USB_GET_INTERFACE_DESCRIPTOR    UsbGetInterfaceDescriptor;\r
+  PEI_USB_GET_ENDPOINT_DESCRIPTOR     UsbGetEndpointDescriptor;\r
+  PEI_USB_PORT_RESET                  UsbPortReset;\r
 };\r
 \r
-extern EFI_GUID gPeiUsbIoPpiGuid;\r
+extern EFI_GUID  gPeiUsbIoPpiGuid;\r
 \r
 #endif\r