- Provides direction to the configuration driver whether to use the HII \r
- database or a passed-in set of data. This function also establishes a \r
- pointer to the calling driver¡¯s callback interface. \r
-\r
- @param This A pointer to the EFI_FORM_BROWSER_PROTOCOL instance.\r
- @param UseDatabase Determines whether the HII database is to be\r
- used to gather information. If the value is FALSE, the configuration\r
- driver will get the information provided in the passed-in Packet parameters.\r
- @param Handle A pointer to an array of HII handles to display. This value\r
- should correspond to the value of the HII form package that is required to\r
- be displayed.\r
- @param HandleCount The number of handles in the array specified by Handle.\r
- @param Packet A pointer to a set of data containing pointers to IFR\r
- and/or string data.\r
- @param CallbackHandle The handle to the driver¡¯s callback interface.\r
- This parameter is used only when the UseDatabase parameter is FALSE\r
- and an application wants to register a callback with the browser\r
- @param NvMapOverride This buffer is used only when there is no NV variable\r
- to define the current settings and the caller needs to provide to the browser\r
- the current settings for the "fake" NV variable.\r
- @param ScreenDimensions Allows the browser to be called so that it occupies\r
- a portion of the physical screen instead of dynamically determining the\r
- screen dimensions.\r
- @param ResetRequired This BOOLEAN value will tell the caller if a reset\r
- is required based on the data that might have been changed. The ResetRequired\r
- parameter is primarily applicable for configuration applications, and is an\r
- optional parameter.\r
-\r
- @retval EFI_SUCCESS The function completed successfully\r
- @retval EFI_NOT_FOUND The variable was not found.\r
- @retval EFI_BUFFER_TOO_SMALL The DataSize is too small for the result.\r
- DataSize has been updated with the size needed to complete the request.\r
- @retval EFI_INVALID_PARAMETER One of the parameters has an invalid value.\r
- @retval EFI_DEVICE_ERROR The variable could not be saved due to a hardware failure.\r
-\r
+ \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_BROWSER_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
+ \r
+ @retval EFI_DEVICE_ERROR The variable could not be saved due\r
+ to a hardware failure.\r
+ \r