]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Protocol/FormBrowser2.h
MdePkg: Replace BSD License with BSD+Patent License
[mirror_edk2.git] / MdePkg / Include / Protocol / FormBrowser2.h
index 5b530f6cc609cccb5c6e5452f41c7267d0c2dc48..fa2a8c01a0a2d85a8ed49bf6fe6bacd99f3c42ae 100644 (file)
@@ -1,17 +1,11 @@
 /** @file\r
   This protocol is defined in UEFI spec.\r
-  \r
-  The EFI_FORM_BROWSER2_PROTOCOL is the interface to call for drivers to \r
+\r
+  The EFI_FORM_BROWSER2_PROTOCOL is the interface to call for drivers to\r
   leverage the EFI configuration driver interface.\r
-  \r
-Copyright (c) 2006 - 2010, Intel Corporation.  All rights reserved<BR>\r
-This program and the accompanying materials are licensed and made available under \r
-the terms and conditions of the BSD License that accompanies this distribution.  \r
-The 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
+\r
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
 **/\r
 \r
@@ -29,11 +23,11 @@ typedef struct _EFI_FORM_BROWSER2_PROTOCOL   EFI_FORM_BROWSER2_PROTOCOL;
 \r
 \r
 /**\r
-   \r
+\r
   @param LeftColumn   The value that designates the text column\r
                       where the browser window will begin from\r
                       the left-hand side of the screen\r
-                      \r
+\r
   @param RightColumn  The value that designates the text\r
                       column where the browser window will end\r
                       on the right-hand side of the screen.\r
@@ -44,7 +38,7 @@ typedef struct _EFI_FORM_BROWSER2_PROTOCOL   EFI_FORM_BROWSER2_PROTOCOL;
 \r
   @param BottomRow    The value that designates the text row from the\r
                       bottom of the screen where the browser\r
-                      window will end. \r
+                      window will end.\r
 **/\r
 typedef struct {\r
   UINTN   LeftColumn;\r
@@ -59,43 +53,48 @@ typedef UINTN EFI_BROWSER_ACTION_REQUEST;
 #define EFI_BROWSER_ACTION_REQUEST_RESET  1\r
 #define EFI_BROWSER_ACTION_REQUEST_SUBMIT 2\r
 #define EFI_BROWSER_ACTION_REQUEST_EXIT   3\r
+#define EFI_BROWSER_ACTION_REQUEST_FORM_SUBMIT_EXIT  4\r
+#define EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD_EXIT 5\r
+#define EFI_BROWSER_ACTION_REQUEST_FORM_APPLY        6\r
+#define EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD      7\r
+#define EFI_BROWSER_ACTION_REQUEST_RECONNECT         8\r
 \r
 \r
 /**\r
   Initialize the browser to display the specified configuration forms.\r
 \r
-  This function is the primary interface to the internal forms-based browser. \r
-  The forms browser will display forms associated with the specified Handles. \r
-  The browser will select all forms in packages which have the specified Type \r
+  This function is the primary interface to the internal forms-based browser.\r
+  The forms browser will display forms associated with the specified Handles.\r
+  The browser will select all forms in packages which have the specified Type\r
   and (for EFI_HII_PACKAGE_TYPE_GUID) the specified PackageGuid.\r
 \r
   @param This            A pointer to the EFI_FORM_BROWSER2_PROTOCOL instance\r
 \r
-  @param Handles         A pointer to an array of Handles. This value should correspond \r
+  @param Handles         A pointer to an array of Handles. This value should correspond\r
                          to the value of the HII form package that is required to be displayed.\r
 \r
   @param HandleCount     The number of Handles specified in Handle.\r
 \r
   @param FormSetGuid     This field points to the EFI_GUID which must match the Guid field or one of the\r
                          elements of the ClassId field  in the EFI_IFR_FORM_SET op-code.  If\r
-                         FormsetGuid is NULL, then this function will display the the form set class\r
+                         FormsetGuid is NULL, then this function will display the form set class\r
                          EFI_HII_PLATFORM_SETUP_FORMSET_GUID.\r
 \r
   @param FormId          This field specifies the identifier of the form within the form set to render as the first\r
                          displayable page. If this field has a value of 0x0000, then the Forms Browser will\r
                          render the first enabled form in the form set.\r
 \r
-  @param ScreenDimensions Points to recommended form dimensions, including any non-content area, in \r
+  @param ScreenDimensions Points to recommended form dimensions, including any non-content area, in\r
                           characters.\r
 \r
   @param ActionRequest   Points to the action recommended by the form.\r
 \r
   @retval EFI_SUCCESS           The function completed successfully\r
-  \r
+\r
   @retval EFI_NOT_FOUND         The variable was not found.\r
-  \r
+\r
   @retval EFI_INVALID_PARAMETER One of the parameters has an\r
-                                invalid value.  \r
+                                invalid value.\r
 **/\r
 typedef\r
 EFI_STATUS\r
@@ -121,7 +120,7 @@ EFI_STATUS
 \r
   @param ResultsDataSize  A pointer to the size of the buffer\r
                           associated with ResultsData. On input, the size in\r
-                          bytes of ResultsData. On output, the size of data \r
+                          bytes of ResultsData. On output, the size of data\r
                           returned in ResultsData.\r
 \r
   @param ResultsData    A string returned from an IFR browser or\r
@@ -143,7 +142,7 @@ EFI_STATUS
 \r
   @retval EFI_SUCCESS           The results have been distributed or are\r
                                 awaiting distribution.\r
-  \r
+\r
   @retval EFI_OUT_OF_RESOURCES  The ResultsDataSize specified\r
                                 was too small to contain the\r
                                 results data.\r
@@ -161,7 +160,7 @@ EFI_STATUS
 );\r
 \r
 ///\r
-/// This interface will allow the caller to direct the configuration \r
+/// This interface will allow the caller to direct the configuration\r
 /// driver to use either the HII database or use the passed-in packet of data.\r
 ///\r
 struct _EFI_FORM_BROWSER2_PROTOCOL {\r