- \r
- This function is the primary interface to the internal\r
- forms-based browser. By calling this routine, one is directing\r
- the browser to use a variety of passed-in information or\r
- primarily use the HII database as the source of information.\r
-\r
- @param This A pointer to the EFI_FORM_BROWSER2_PROTOCOL\r
- instance.\r
-\r
- @param Handle A pointer to an array of HII handles to\r
- display. This value should correspond to the\r
- value of the HII form package that is required\r
- to be displayed.\r
-\r
- @param HandleCount The number of handles in the array\r
- specified by Handle.\r
-\r
- @param SingleUse If FALSE, the browser operates as a standard\r
- forms processor and exits only when\r
- explicitly requested by the user. If TRUE,\r
- the browser will return immediately after\r
- processing the first user-generated\r
- selection.\r
-\r
- @param ScreenDimensions Allows the browser to be called so\r
- that it occupies a portion of the\r
- physical screen instead of\r
- dynamically determining the screen\r
- dimensions. If the input values\r
- violate the platform policy then the\r
- dimensions will be dynamically\r
- adjusted to comply.\r
-\r
- @param ResetRequired This BOOLEAN value will tell the caller\r
- if a reset is required based on the data\r
- that might have been changed. The\r
- ResetRequired parameter is primarily\r
- applicable for configuration\r
- applications, and is an optional\r
- parameter.\r
-\r
- @retval EFI_SUCCESS The function completed successfully\r
- \r
- @retval EFI_NOT_FOUND The variable was not found.\r
- \r
- @retval EFI_BUFFER_TOO_SMALL The DataSize is too small for\r
- the result. DataSize has been\r
- updated with the size needed to\r
- complete the request.\r
- \r
- @retval EFI_INVALID_PARAMETER One of the parameters has an\r
- invalid value.\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
+ 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
+ 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 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
+ characters.\r
+\r
+ @param ActionRequest Points to the action recommended by the form.\r
+\r
+ @retval EFI_SUCCESS The function completed successfully\r