[mirror_edk2.git] / MdeModulePkg / Universal / SetupBrowserDxe / Setup.c

/** @file\r
Entry and initialization module for the browser.\r
\r
Copyright (c) 2007 - 2011, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  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
**/\r
\r
#include "Setup.h"\r
\r
SETUP_DRIVER_PRIVATE_DATA  mPrivateData = {\r
  SETUP_DRIVER_SIGNATURE,\r
  NULL,\r
  {\r
    SendForm,\r
    BrowserCallback\r
  }\r
};\r
\r
EFI_HII_DATABASE_PROTOCOL         *mHiiDatabase;\r
EFI_HII_STRING_PROTOCOL           *mHiiString;\r
EFI_HII_CONFIG_ROUTING_PROTOCOL   *mHiiConfigRouting;\r
\r
UINTN           gBrowserContextCount = 0;\r
LIST_ENTRY      gBrowserContextList = INITIALIZE_LIST_HEAD_VARIABLE (gBrowserContextList);\r
\r
BANNER_DATA           *gBannerData;\r
EFI_HII_HANDLE        gFrontPageHandle;\r
UINTN                 gClassOfVfr;\r
UINTN                 gFunctionKeySetting;\r
BOOLEAN               gResetRequired;\r
EFI_HII_HANDLE        gHiiHandle;\r
UINT16                gDirection;\r
EFI_SCREEN_DESCRIPTOR gScreenDimensions;\r
\r
//\r
// Browser Global Strings\r
//\r
CHAR16            *gFunctionNineString;\r
CHAR16            *gFunctionTenString;\r
CHAR16            *gEnterString;\r
CHAR16            *gEnterCommitString;\r
CHAR16            *gEnterEscapeString;\r
CHAR16            *gEscapeString;\r
CHAR16            *gSaveFailed;\r
CHAR16            *gMoveHighlight;\r
CHAR16            *gMakeSelection;\r
CHAR16            *gDecNumericInput;\r
CHAR16            *gHexNumericInput;\r
CHAR16            *gToggleCheckBox;\r
CHAR16            *gPromptForData;\r
CHAR16            *gPromptForPassword;\r
CHAR16            *gPromptForNewPassword;\r
CHAR16            *gConfirmPassword;\r
CHAR16            *gConfirmError;\r
CHAR16            *gPassowordInvalid;\r
CHAR16            *gPressEnter;\r
CHAR16            *gEmptyString;\r
CHAR16            *gAreYouSure;\r
CHAR16            *gYesResponse;\r
CHAR16            *gNoResponse;\r
CHAR16            *gMiniString;\r
CHAR16            *gPlusString;\r
CHAR16            *gMinusString;\r
CHAR16            *gAdjustNumber;\r
CHAR16            *gSaveChanges;\r
CHAR16            *gOptionMismatch;\r
CHAR16            *gFormSuppress;\r
\r
CHAR16            *mUnknownString = L"!";\r
\r
CHAR16            gPromptBlockWidth;\r
CHAR16            gOptionBlockWidth;\r
CHAR16            gHelpBlockWidth;\r
\r
EFI_GUID  gZeroGuid = {0, 0, 0, {0, 0, 0, 0, 0, 0, 0, 0}};\r
EFI_GUID  gSetupBrowserGuid = {\r
  0xab368524, 0xb60c, 0x495b, {0xa0, 0x9, 0x12, 0xe8, 0x5b, 0x1a, 0xea, 0x32}\r
};\r
\r
FORM_BROWSER_FORMSET  *gOldFormSet;\r
\r
FUNCTIION_KEY_SETTING gFunctionKeySettingTable[] = {\r
  //\r
  // Boot Manager\r
  //\r
  {\r
    {\r
      0x847bc3fe,\r
      0xb974,\r
      0x446d,\r
      {\r
        0x94,\r
        0x49,\r
        0x5a,\r
        0xd5,\r
        0x41,\r
        0x2e,\r
        0x99,\r
        0x3b\r
      }\r
    },\r
    NONE_FUNCTION_KEY_SETTING\r
  },\r
  //\r
  // Device Manager\r
  //\r
  {\r
    {\r
      0x3ebfa8e6,\r
      0x511d,\r
      0x4b5b,\r
      {\r
        0xa9,\r
        0x5f,\r
        0xfb,\r
        0x38,\r
        0x26,\r
        0xf,\r
        0x1c,\r
        0x27\r
      }\r
    },\r
    NONE_FUNCTION_KEY_SETTING\r
  },\r
  //\r
  // BMM FormSet.\r
  //\r
  {\r
    {\r
      0x642237c7,\r
      0x35d4,\r
      0x472d,\r
      {\r
        0x83,\r
        0x65,\r
        0x12,\r
        0xe0,\r
        0xcc,\r
        0xf2,\r
        0x7a,\r
        0x22\r
      }\r
    },\r
    NONE_FUNCTION_KEY_SETTING\r
  },\r
  //\r
  // BMM File Explorer FormSet.\r
  //\r
  {\r
    {\r
      0x1f2d63e1,\r
      0xfebd,\r
      0x4dc7,\r
      {\r
        0x9c,\r
        0xc5,\r
        0xba,\r
        0x2b,\r
        0x1c,\r
        0xef,\r
        0x9c,\r
        0x5b\r
      }\r
    },\r
    NONE_FUNCTION_KEY_SETTING\r
  },\r
};\r
\r
/**\r
  This is the routine which an external caller uses to direct the browser\r
  where to obtain it's information.\r
\r
\r
  @param This            The Form Browser protocol instanse.\r
  @param Handles         A pointer to an array of Handles.  If HandleCount > 1 we\r
                         display a list of the formsets for the handles specified.\r
  @param HandleCount     The number of Handles specified in Handle.\r
  @param FormSetGuid     This field points to the EFI_GUID which must match the Guid\r
                         field in the EFI_IFR_FORM_SET op-code for the specified\r
                         forms-based package. If FormSetGuid is NULL, then this\r
                         function will display the first found forms package.\r
  @param FormId          This field specifies which EFI_IFR_FORM to render as the first\r
                         displayable page. If this field has a value of 0x0000, then\r
                         the forms browser will render the specified forms in their encoded order.\r
  @param ScreenDimensions Points to recommended form dimensions, including any non-content area, in\r
                          characters.\r
  @param ActionRequest   Points to the action recommended by the form.\r
\r
  @retval  EFI_SUCCESS            The function completed successfully.\r
  @retval  EFI_INVALID_PARAMETER  One of the parameters has an invalid value.\r
  @retval  EFI_NOT_FOUND          No valid forms could be found to display.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SendForm (\r
  IN  CONST EFI_FORM_BROWSER2_PROTOCOL *This,\r
  IN  EFI_HII_HANDLE                   *Handles,\r
  IN  UINTN                            HandleCount,\r
  IN  EFI_GUID                         *FormSetGuid, OPTIONAL\r
  IN  UINT16                           FormId, OPTIONAL\r
  IN  CONST EFI_SCREEN_DESCRIPTOR      *ScreenDimensions, OPTIONAL\r
  OUT EFI_BROWSER_ACTION_REQUEST       *ActionRequest  OPTIONAL\r
  )\r
{\r
  EFI_STATUS                    Status;\r
  UI_MENU_SELECTION             *Selection;\r
  UINTN                         Index;\r
  FORM_BROWSER_FORMSET          *FormSet;\r
\r
  //\r
  // Save globals used by SendForm()\r
  //\r
  SaveBrowserContext ();\r
\r
  Status = EFI_SUCCESS;\r
  ZeroMem (&gScreenDimensions, sizeof (EFI_SCREEN_DESCRIPTOR));\r
\r
  //\r
  // Seed the dimensions in the global\r
  //\r
  gST->ConOut->QueryMode (\r
                 gST->ConOut,\r
                 gST->ConOut->Mode->Mode,\r
                 &gScreenDimensions.RightColumn,\r
                 &gScreenDimensions.BottomRow\r
                 );\r
\r
  if (ScreenDimensions != NULL) {\r
    //\r
    // Check local dimension vs. global dimension.\r
    //\r
    if ((gScreenDimensions.RightColumn < ScreenDimensions->RightColumn) ||\r
        (gScreenDimensions.BottomRow < ScreenDimensions->BottomRow)\r
        ) {\r
      Status = EFI_INVALID_PARAMETER;\r
      goto Done;\r
    } else {\r
      //\r
      // Local dimension validation.\r
      //\r
      if ((ScreenDimensions->RightColumn > ScreenDimensions->LeftColumn) &&\r
          (ScreenDimensions->BottomRow > ScreenDimensions->TopRow) &&\r
          ((ScreenDimensions->RightColumn - ScreenDimensions->LeftColumn) > 2) &&\r
          (\r
            (ScreenDimensions->BottomRow - ScreenDimensions->TopRow) > STATUS_BAR_HEIGHT +\r
            SCROLL_ARROW_HEIGHT *\r
            2 +\r
            FRONT_PAGE_HEADER_HEIGHT +\r
            FOOTER_HEIGHT +\r
            1\r
          )\r
        ) {\r
        CopyMem (&gScreenDimensions, (VOID *) ScreenDimensions, sizeof (EFI_SCREEN_DESCRIPTOR));\r
      } else {\r
        Status = EFI_INVALID_PARAMETER;\r
        goto Done;\r
      }\r
    }\r
  }\r
\r
  gOptionBlockWidth = (CHAR16) ((gScreenDimensions.RightColumn - gScreenDimensions.LeftColumn) / 3);\r
  gPromptBlockWidth = (CHAR16) (gOptionBlockWidth + LEFT_SKIPPED_COLUMNS);\r
  gHelpBlockWidth   = (CHAR16) (gOptionBlockWidth - LEFT_SKIPPED_COLUMNS);\r
\r
  //\r
  // Initialize the strings for the browser, upon exit of the browser, the strings will be freed\r
  //\r
  InitializeBrowserStrings ();\r
\r
  gFunctionKeySetting = DEFAULT_FUNCTION_KEY_SETTING;\r
\r
  //\r
  // Ensure we are in Text mode\r
  //\r
  gST->ConOut->SetAttribute (gST->ConOut, EFI_TEXT_ATTR (EFI_LIGHTGRAY, EFI_BLACK));\r
\r
  for (Index = 0; Index < HandleCount; Index++) {\r
    Selection = AllocateZeroPool (sizeof (UI_MENU_SELECTION));\r
    ASSERT (Selection != NULL);\r
\r
    Selection->Handle = Handles[Index];\r
    if (FormSetGuid != NULL) {\r
      CopyMem (&Selection->FormSetGuid, FormSetGuid, sizeof (EFI_GUID));\r
      Selection->FormId = FormId;\r
    }\r
\r
    gOldFormSet = NULL;\r
\r
    do {\r
      FormSet = AllocateZeroPool (sizeof (FORM_BROWSER_FORMSET));\r
      ASSERT (FormSet != NULL);\r
\r
      //\r
      // Initialize internal data structures of FormSet\r
      //\r
      Status = InitializeFormSet (Selection->Handle, &Selection->FormSetGuid, FormSet);\r
      if (EFI_ERROR (Status) || IsListEmpty (&FormSet->FormListHead)) {\r
        DestroyFormSet (FormSet);\r
        break;\r
      }\r
      Selection->FormSet = FormSet;\r
\r
      //\r
      // Display this formset\r
      //\r
      gCurrentSelection = Selection;\r
\r
      Status = SetupBrowser (Selection);\r
\r
      gCurrentSelection = NULL;\r
\r
      if (EFI_ERROR (Status)) {\r
        break;\r
      }\r
\r
    } while (Selection->Action == UI_ACTION_REFRESH_FORMSET);\r
\r
    if (gOldFormSet != NULL) {\r
      DestroyFormSet (gOldFormSet);\r
      gOldFormSet = NULL;\r
    }\r
\r
    FreePool (Selection);\r
  }\r
\r
  if (ActionRequest != NULL) {\r
    *ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
    if (gResetRequired) {\r
      *ActionRequest = EFI_BROWSER_ACTION_REQUEST_RESET;\r
    }\r
  }\r
\r
  FreeBrowserStrings ();\r
\r
  gST->ConOut->SetAttribute (gST->ConOut, EFI_TEXT_ATTR (EFI_LIGHTGRAY, EFI_BLACK));\r
  gST->ConOut->ClearScreen (gST->ConOut);\r
\r
Done:\r
  //\r
  // Restore globals used by SendForm()\r
  //\r
  RestoreBrowserContext ();\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  This function is called by a callback handler to retrieve uncommitted state\r
  data from the browser.\r
\r
  @param  This                   A pointer to the EFI_FORM_BROWSER2_PROTOCOL\r
                                 instance.\r
  @param  ResultsDataSize        A pointer to the size of the buffer associated\r
                                 with ResultsData.\r
  @param  ResultsData            A string returned from an IFR browser or\r
                                 equivalent. The results string will have no\r
                                 routing information in them.\r
  @param  RetrieveData           A BOOLEAN field which allows an agent to retrieve\r
                                 (if RetrieveData = TRUE) data from the uncommitted\r
                                 browser state information or set (if RetrieveData\r
                                 = FALSE) data in the uncommitted browser state\r
                                 information.\r
  @param  VariableGuid           An optional field to indicate the target variable\r
                                 GUID name to use.\r
  @param  VariableName           An optional field to indicate the target\r
                                 human-readable variable name.\r
\r
  @retval EFI_SUCCESS            The results have been distributed or are awaiting\r
                                 distribution.\r
  @retval EFI_BUFFER_TOO_SMALL   The ResultsDataSize specified was too small to\r
                                 contain the results data.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BrowserCallback (\r
  IN CONST EFI_FORM_BROWSER2_PROTOCOL  *This,\r
  IN OUT UINTN                         *ResultsDataSize,\r
  IN OUT EFI_STRING                    ResultsData,\r
  IN BOOLEAN                           RetrieveData,\r
  IN CONST EFI_GUID                    *VariableGuid, OPTIONAL\r
  IN CONST CHAR16                      *VariableName  OPTIONAL\r
  )\r
{\r
  EFI_STATUS            Status;\r
  LIST_ENTRY            *Link;\r
  FORMSET_STORAGE       *Storage;\r
  FORM_BROWSER_FORMSET  *FormSet;\r
  BOOLEAN               Found;\r
  CHAR16                *ConfigResp;\r
  CHAR16                *StrPtr;\r
  UINTN                 BufferSize;\r
  UINTN                 TmpSize;\r
\r
  if (ResultsDataSize == NULL || ResultsData == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  if (gCurrentSelection == NULL) {\r
    return EFI_NOT_READY;\r
  }\r
\r
  Storage = NULL;\r
  ConfigResp = NULL;\r
  FormSet = gCurrentSelection->FormSet;\r
\r
  //\r
  // Find target storage\r
  //\r
  Link = GetFirstNode (&FormSet->StorageListHead);\r
  if (IsNull (&FormSet->StorageListHead, Link)) {\r
    return EFI_UNSUPPORTED;\r
  }\r
\r
  if (VariableGuid != NULL) {\r
    //\r
    // Try to find target storage\r
    //\r
    Found = FALSE;\r
    while (!IsNull (&FormSet->StorageListHead, Link)) {\r
      Storage = FORMSET_STORAGE_FROM_LINK (Link);\r
      Link = GetNextNode (&FormSet->StorageListHead, Link);\r
\r
      if (CompareGuid (&Storage->Guid, (EFI_GUID *) VariableGuid)) {\r
        if (Storage->Type == EFI_HII_VARSTORE_BUFFER) {\r
          //\r
          // Buffer storage require both GUID and Name\r
          //\r
          if (VariableName == NULL) {\r
            return EFI_NOT_FOUND;\r
          }\r
\r
          if (StrCmp (Storage->Name, (CHAR16 *) VariableName) != 0) {\r
            continue;\r
          }\r
        }\r
        Found = TRUE;\r
        break;\r
      }\r
    }\r
\r
    if (!Found) {\r
      return EFI_NOT_FOUND;\r
    }\r
  } else {\r
    //\r
    // GUID/Name is not specified, take the first storage in FormSet\r
    //\r
    Storage = FORMSET_STORAGE_FROM_LINK (Link);\r
  }\r
\r
  if (RetrieveData) {\r
    //\r
    // Skip if there is no RequestElement\r
    //\r
    if (Storage->ElementCount == 0) {\r
      return EFI_SUCCESS;\r
    }\r
\r
    //\r
    // Generate <ConfigResp>\r
    //\r
    Status = StorageToConfigResp (Storage, &ConfigResp, FALSE);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    //\r
    // Skip <ConfigHdr> and '&' to point to <ConfigBody>\r
    //\r
    StrPtr = ConfigResp + StrLen (Storage->ConfigHdr) + 1;\r
\r
    BufferSize = StrSize (StrPtr);\r
    if (*ResultsDataSize < BufferSize) {\r
      *ResultsDataSize = BufferSize;\r
\r
      FreePool (ConfigResp);\r
      return EFI_BUFFER_TOO_SMALL;\r
    }\r
\r
    *ResultsDataSize = BufferSize;\r
    CopyMem (ResultsData, StrPtr, BufferSize);\r
\r
    FreePool (ConfigResp);\r
  } else {\r
    //\r
    // Prepare <ConfigResp>\r
    //\r
    TmpSize = StrLen (ResultsData);\r
    BufferSize = (TmpSize + StrLen (Storage->ConfigHdr) + 2) * sizeof (CHAR16);\r
    ConfigResp = AllocateZeroPool (BufferSize);\r
    ASSERT (ConfigResp != NULL);\r
\r
    StrCpy (ConfigResp, Storage->ConfigHdr);\r
    StrCat (ConfigResp, L"&");\r
    StrCat (ConfigResp, ResultsData);\r
\r
    //\r
    // Update Browser uncommited data\r
    //\r
    Status = ConfigRespToStorage (Storage, ConfigResp);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Initialize Setup Browser driver.\r
\r
  @param ImageHandle     The image handle.\r
  @param SystemTable     The system table.\r
\r
  @retval EFI_SUCCESS    The Setup Browser module is initialized correctly..\r
  @return Other value if failed to initialize the Setup Browser module.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
InitializeSetup (\r
  IN EFI_HANDLE           ImageHandle,\r
  IN EFI_SYSTEM_TABLE     *SystemTable\r
  )\r
{\r
  EFI_STATUS                  Status;\r
\r
  //\r
  // Locate required Hii relative protocols\r
  //\r
  Status = gBS->LocateProtocol (\r
                  &gEfiHiiDatabaseProtocolGuid,\r
                  NULL,\r
                  (VOID **) &mHiiDatabase\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  Status = gBS->LocateProtocol (\r
                  &gEfiHiiStringProtocolGuid,\r
                  NULL,\r
                  (VOID **) &mHiiString\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  Status = gBS->LocateProtocol (\r
                  &gEfiHiiConfigRoutingProtocolGuid,\r
                  NULL,\r
                  (VOID **) &mHiiConfigRouting\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Publish our HII data\r
  //\r
  gHiiHandle = HiiAddPackages (\r
                 &gSetupBrowserGuid,\r
                 ImageHandle,\r
                 SetupBrowserStrings,\r
                 NULL\r
                 );\r
  ASSERT (gHiiHandle != NULL);\r
\r
  //\r
  // Initialize Driver private data\r
  //\r
  gBannerData = AllocateZeroPool (sizeof (BANNER_DATA));\r
  ASSERT (gBannerData != NULL);\r
\r
  //\r
  // Install FormBrowser2 protocol\r
  //\r
  mPrivateData.Handle = NULL;\r
  Status = gBS->InstallProtocolInterface (\r
                  &mPrivateData.Handle,\r
                  &gEfiFormBrowser2ProtocolGuid,\r
                  EFI_NATIVE_INTERFACE,\r
                  &mPrivateData.FormBrowser2\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Create a new string in HII Package List.\r
\r
  @param  String                 The String to be added\r
  @param  HiiHandle              The package list in the HII database to insert the\r
                                 specified string.\r
\r
  @return The output string.\r
\r
**/\r
EFI_STRING_ID\r
NewString (\r
  IN  CHAR16                   *String,\r
  IN  EFI_HII_HANDLE           HiiHandle\r
  )\r
{\r
  EFI_STRING_ID  StringId;\r
\r
  StringId = HiiSetString (HiiHandle, 0, String, NULL);\r
  ASSERT (StringId != 0);\r
\r
  return StringId;\r
}\r
\r
\r
/**\r
  Delete a string from HII Package List.\r
\r
  @param  StringId               Id of the string in HII database.\r
  @param  HiiHandle              The HII package list handle.\r
\r
  @retval EFI_SUCCESS            The string was deleted successfully.\r
\r
**/\r
EFI_STATUS\r
DeleteString (\r
  IN  EFI_STRING_ID            StringId,\r
  IN  EFI_HII_HANDLE           HiiHandle\r
  )\r
{\r
  CHAR16  NullChar;\r
\r
  NullChar = CHAR_NULL;\r
  HiiSetString (HiiHandle, StringId, &NullChar, NULL);\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Get the string based on the StringId and HII Package List Handle.\r
\r
  @param  Token                  The String's ID.\r
  @param  HiiHandle              The package list in the HII database to search for\r
                                 the specified string.\r
\r
  @return The output string.\r
\r
**/\r
CHAR16 *\r
GetToken (\r
  IN  EFI_STRING_ID                Token,\r
  IN  EFI_HII_HANDLE               HiiHandle\r
  )\r
{\r
  EFI_STRING  String;\r
\r
  if (HiiHandle == NULL) {\r
    return NULL;\r
  }\r
\r
  String = HiiGetString (HiiHandle, Token, NULL);\r
  if (String == NULL) {\r
    String = AllocateCopyPool (sizeof (mUnknownString), mUnknownString);\r
    ASSERT (String != NULL);\r
  }\r
  return (CHAR16 *) String;\r
}\r
\r
\r
/**\r
  Allocate new memory and then copy the Unicode string Source to Destination.\r
\r
  @param  Dest                   Location to copy string\r
  @param  Src                    String to copy\r
\r
**/\r
VOID\r
NewStringCpy (\r
  IN OUT CHAR16       **Dest,\r
  IN CHAR16           *Src\r
  )\r
{\r
  if (*Dest != NULL) {\r
    FreePool (*Dest);\r
  }\r
  *Dest = AllocateCopyPool (StrSize (Src), Src);\r
  ASSERT (*Dest != NULL);\r
}\r
\r
\r
/**\r
  Allocate new memory and concatinate Source on the end of Destination.\r
\r
  @param  Dest                   String to added to the end of.\r
  @param  Src                    String to concatinate.\r
\r
**/\r
VOID\r
NewStringCat (\r
  IN OUT CHAR16       **Dest,\r
  IN CHAR16           *Src\r
  )\r
{\r
  CHAR16  *NewString;\r
  UINTN   TmpSize;\r
\r
  if (*Dest == NULL) {\r
    NewStringCpy (Dest, Src);\r
    return;\r
  }\r
\r
  TmpSize = StrSize (*Dest);\r
  NewString = AllocateZeroPool (TmpSize + StrSize (Src) - 1);\r
  ASSERT (NewString != NULL);\r
\r
  StrCpy (NewString, *Dest);\r
  StrCat (NewString, Src);\r
\r
  FreePool (*Dest);\r
  *Dest = NewString;\r
}\r
\r
\r
/**\r
  Synchronize Storage's Edit copy to Shadow copy.\r
\r
  @param  Storage                The Storage to be synchronized.\r
\r
**/\r
VOID\r
SynchronizeStorage (\r
  IN FORMSET_STORAGE         *Storage\r
  )\r
{\r
  LIST_ENTRY              *Link;\r
  NAME_VALUE_NODE         *Node;\r
\r
  switch (Storage->Type) {\r
  case EFI_HII_VARSTORE_BUFFER:\r
    CopyMem (Storage->Buffer, Storage->EditBuffer, Storage->Size);\r
    break;\r
\r
  case EFI_HII_VARSTORE_NAME_VALUE:\r
    Link = GetFirstNode (&Storage->NameValueListHead);\r
    while (!IsNull (&Storage->NameValueListHead, Link)) {\r
      Node = NAME_VALUE_NODE_FROM_LINK (Link);\r
\r
      NewStringCpy (&Node->Value, Node->EditValue);\r
\r
      Link = GetNextNode (&Storage->NameValueListHead, Link);\r
    }\r
    break;\r
\r
  case EFI_HII_VARSTORE_EFI_VARIABLE:\r
  default:\r
    break;\r
  }\r
}\r
\r
\r
/**\r
  Get Value for given Name from a NameValue Storage.\r
\r
  @param  Storage                The NameValue Storage.\r
  @param  Name                   The Name.\r
  @param  Value                  The retured Value.\r
\r
  @retval EFI_SUCCESS            Value found for given Name.\r
  @retval EFI_NOT_FOUND          No such Name found in NameValue storage.\r
\r
**/\r
EFI_STATUS\r
GetValueByName (\r
  IN FORMSET_STORAGE         *Storage,\r
  IN CHAR16                  *Name,\r
  IN OUT CHAR16              **Value\r
  )\r
{\r
  LIST_ENTRY              *Link;\r
  NAME_VALUE_NODE         *Node;\r
\r
  *Value = NULL;\r
\r
  Link = GetFirstNode (&Storage->NameValueListHead);\r
  while (!IsNull (&Storage->NameValueListHead, Link)) {\r
    Node = NAME_VALUE_NODE_FROM_LINK (Link);\r
\r
    if (StrCmp (Name, Node->Name) == 0) {\r
      NewStringCpy (Value, Node->EditValue);\r
      return EFI_SUCCESS;\r
    }\r
\r
    Link = GetNextNode (&Storage->NameValueListHead, Link);\r
  }\r
\r
  return EFI_NOT_FOUND;\r
}\r
\r
\r
/**\r
  Set Value of given Name in a NameValue Storage.\r
\r
  @param  Storage                The NameValue Storage.\r
  @param  Name                   The Name.\r
  @param  Value                  The Value to set.\r
  @param  Edit                   Whether update editValue or Value.\r
\r
  @retval EFI_SUCCESS            Value found for given Name.\r
  @retval EFI_NOT_FOUND          No such Name found in NameValue storage.\r
\r
**/\r
EFI_STATUS\r
SetValueByName (\r
  IN FORMSET_STORAGE         *Storage,\r
  IN CHAR16                  *Name,\r
  IN CHAR16                  *Value,\r
  IN BOOLEAN                 Edit\r
  )\r
{\r
  LIST_ENTRY              *Link;\r
  NAME_VALUE_NODE         *Node;\r
  CHAR16                  *Buffer;\r
\r
  Link = GetFirstNode (&Storage->NameValueListHead);\r
  while (!IsNull (&Storage->NameValueListHead, Link)) {\r
    Node = NAME_VALUE_NODE_FROM_LINK (Link);\r
\r
    if (StrCmp (Name, Node->Name) == 0) {\r
      if (Edit) {\r
        Buffer = Node->EditValue;\r
      } else {\r
        Buffer = Node->Value;\r
      }\r
      if (Buffer != NULL) {\r
        FreePool (Buffer);\r
      }\r
      Buffer = AllocateCopyPool (StrSize (Value), Value);\r
      ASSERT (Buffer != NULL);\r
      if (Edit) {\r
        Node->EditValue = Buffer;\r
      } else {\r
        Node->Value = Buffer;\r
      }\r
      return EFI_SUCCESS;\r
    }\r
\r
    Link = GetNextNode (&Storage->NameValueListHead, Link);\r
  }\r
\r
  return EFI_NOT_FOUND;\r
}\r
\r
\r
/**\r
  Convert setting of Buffer Storage or NameValue Storage to <ConfigResp>.\r
\r
  @param  Buffer                 The Storage to be conveted.\r
  @param  ConfigResp             The returned <ConfigResp>.\r
  @param  SingleForm             Whether update data for single form or formset level.\r
\r
  @retval EFI_SUCCESS            Convert success.\r
  @retval EFI_INVALID_PARAMETER  Incorrect storage type.\r
\r
**/\r
EFI_STATUS\r
StorageToConfigResp (\r
  IN VOID                    *Buffer,\r
  IN CHAR16                  **ConfigResp,\r
  IN BOOLEAN                 SingleForm\r
  )\r
{\r
  EFI_STATUS  Status;\r
  EFI_STRING  Progress;\r
  LIST_ENTRY              *Link;\r
  NAME_VALUE_NODE         *Node;\r
  CHAR16                  *ConfigRequest;\r
  FORMSET_STORAGE         *Storage;\r
  FORM_BROWSER_CONFIG_REQUEST  *ConfigInfo;\r
\r
  Status = EFI_SUCCESS;\r
  if (SingleForm) {\r
    ConfigInfo    = (FORM_BROWSER_CONFIG_REQUEST *) Buffer;\r
    Storage       = ConfigInfo->Storage;\r
    ConfigRequest = ConfigInfo->ConfigRequest;\r
  } else {\r
    Storage       = (FORMSET_STORAGE *) Buffer;\r
    ConfigRequest = Storage->ConfigRequest;\r
  }\r
\r
  switch (Storage->Type) {\r
  case EFI_HII_VARSTORE_BUFFER:\r
    Status = mHiiConfigRouting->BlockToConfig (\r
                                  mHiiConfigRouting,\r
                                  ConfigRequest,\r
                                  Storage->EditBuffer,\r
                                  Storage->Size,\r
                                  ConfigResp,\r
                                  &Progress\r
                                  );\r
    break;\r
\r
  case EFI_HII_VARSTORE_NAME_VALUE:\r
    *ConfigResp = NULL;\r
    NewStringCat (ConfigResp, Storage->ConfigHdr);\r
\r
    Link = GetFirstNode (&Storage->NameValueListHead);\r
    while (!IsNull (&Storage->NameValueListHead, Link)) {\r
      Node = NAME_VALUE_NODE_FROM_LINK (Link);\r
\r
      if (StrStr (ConfigRequest, Node->Name) != NULL) {\r
        NewStringCat (ConfigResp, L"&");\r
        NewStringCat (ConfigResp, Node->Name);\r
        NewStringCat (ConfigResp, L"=");\r
        NewStringCat (ConfigResp, Node->EditValue);\r
      }\r
      Link = GetNextNode (&Storage->NameValueListHead, Link);\r
    }\r
    break;\r
\r
  case EFI_HII_VARSTORE_EFI_VARIABLE:\r
  default:\r
    Status = EFI_INVALID_PARAMETER;\r
    break;\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Convert <ConfigResp> to settings in Buffer Storage or NameValue Storage.\r
\r
  @param  Storage                The Storage to receive the settings.\r
  @param  ConfigResp             The <ConfigResp> to be converted.\r
\r
  @retval EFI_SUCCESS            Convert success.\r
  @retval EFI_INVALID_PARAMETER  Incorrect storage type.\r
\r
**/\r
EFI_STATUS\r
ConfigRespToStorage (\r
  IN FORMSET_STORAGE         *Storage,\r
  IN CHAR16                  *ConfigResp\r
  )\r
{\r
  EFI_STATUS  Status;\r
  EFI_STRING  Progress;\r
  UINTN       BufferSize;\r
  CHAR16      *StrPtr;\r
  CHAR16      *Name;\r
  CHAR16      *Value;\r
\r
  Status = EFI_SUCCESS;\r
\r
  switch (Storage->Type) {\r
  case EFI_HII_VARSTORE_BUFFER:\r
    BufferSize = Storage->Size;\r
    Status = mHiiConfigRouting->ConfigToBlock (\r
                                  mHiiConfigRouting,\r
                                  ConfigResp,\r
                                  Storage->EditBuffer,\r
                                  &BufferSize,\r
                                  &Progress\r
                                  );\r
    break;\r
\r
  case EFI_HII_VARSTORE_NAME_VALUE:\r
    StrPtr = StrStr (ConfigResp, L"PATH");\r
    if (StrPtr == NULL) {\r
      break;\r
    }\r
    StrPtr = StrStr (ConfigResp, L"&");\r
    while (StrPtr != NULL) {\r
      //\r
      // Skip '&'\r
      //\r
      StrPtr = StrPtr + 1;\r
      Name = StrPtr;\r
      StrPtr = StrStr (StrPtr, L"=");\r
      if (StrPtr == NULL) {\r
        break;\r
      }\r
      *StrPtr = 0;\r
\r
      //\r
      // Skip '='\r
      //\r
      StrPtr = StrPtr + 1;\r
      Value = StrPtr;\r
      StrPtr = StrStr (StrPtr, L"&");\r
      if (StrPtr != NULL) {\r
        *StrPtr = 0;\r
      }\r
      SetValueByName (Storage, Name, Value, TRUE);\r
    }\r
    break;\r
\r
  case EFI_HII_VARSTORE_EFI_VARIABLE:\r
  default:\r
    Status = EFI_INVALID_PARAMETER;\r
    break;\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Get Question's current Value.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  Form                   Form data structure.\r
  @param  Question               Question to be initialized.\r
  @param  Cached                 TRUE:  get from Edit copy FALSE: get from original\r
                                 Storage\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
GetQuestionValue (\r
  IN FORM_BROWSER_FORMSET             *FormSet,\r
  IN FORM_BROWSER_FORM                *Form,\r
  IN OUT FORM_BROWSER_STATEMENT       *Question,\r
  IN BOOLEAN                          Cached\r
  )\r
{\r
  EFI_STATUS          Status;\r
  BOOLEAN             Enabled;\r
  BOOLEAN             Pending;\r
  UINT8               *Dst;\r
  UINTN               StorageWidth;\r
  EFI_TIME            EfiTime;\r
  FORMSET_STORAGE     *Storage;\r
  EFI_IFR_TYPE_VALUE  *QuestionValue;\r
  CHAR16              *ConfigRequest;\r
  CHAR16              *Progress;\r
  CHAR16              *Result;\r
  CHAR16              *Value;\r
  CHAR16              *StringPtr;\r
  UINTN               Length;\r
  UINTN               Index;\r
  UINTN               LengthStr;\r
  BOOLEAN             IsBufferStorage;\r
  BOOLEAN             IsString;\r
  CHAR16              TemStr[5];\r
  UINT8               DigitUint8;\r
\r
  Status = EFI_SUCCESS;\r
\r
  //\r
  // Statement don't have storage, skip them\r
  //\r
  if (Question->QuestionId == 0) {\r
    return Status;\r
  }\r
\r
  //\r
  // Question value is provided by an Expression, evaluate it\r
  //\r
  if (Question->ValueExpression != NULL) {\r
    Status = EvaluateExpression (FormSet, Form, Question->ValueExpression);\r
    if (!EFI_ERROR (Status)) {\r
      CopyMem (&Question->HiiValue, &Question->ValueExpression->Result, sizeof (EFI_HII_VALUE));\r
    }\r
    return Status;\r
  }\r
  \r
  //\r
  // Get question value by read expression.\r
  //\r
  if (Question->ReadExpression != NULL && Form->FormType == STANDARD_MAP_FORM_TYPE) {\r
    Status = EvaluateExpression (FormSet, Form, Question->ReadExpression);\r
    if (!EFI_ERROR (Status) && (Question->ReadExpression->Result.Type < EFI_IFR_TYPE_OTHER)) {\r
      //\r
      // Only update question value to the valid result.\r
      //\r
      CopyMem (&Question->HiiValue, &Question->ReadExpression->Result, sizeof (EFI_HII_VALUE));\r
      return EFI_SUCCESS;\r
    }\r
  }\r
\r
  //\r
  // Question value is provided by RTC\r
  //\r
  Storage = Question->Storage;\r
  QuestionValue = &Question->HiiValue.Value;\r
  if (Storage == NULL) {\r
    //\r
    // It's a Question without storage, or RTC date/time\r
    //\r
    if (Question->Operand == EFI_IFR_DATE_OP || Question->Operand == EFI_IFR_TIME_OP) {\r
      //\r
      // Date and time define the same Flags bit\r
      //\r
      switch (Question->Flags & EFI_QF_DATE_STORAGE) {\r
      case QF_DATE_STORAGE_TIME:\r
        Status = gRT->GetTime (&EfiTime, NULL);\r
        break;\r
\r
      case QF_DATE_STORAGE_WAKEUP:\r
        Status = gRT->GetWakeupTime (&Enabled, &Pending, &EfiTime);\r
        break;\r
\r
      case QF_DATE_STORAGE_NORMAL:\r
      default:\r
        //\r
        // For date/time without storage\r
        //\r
        return EFI_SUCCESS;\r
      }\r
\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
\r
      if (Question->Operand == EFI_IFR_DATE_OP) {\r
        QuestionValue->date.Year  = EfiTime.Year;\r
        QuestionValue->date.Month = EfiTime.Month;\r
        QuestionValue->date.Day   = EfiTime.Day;\r
      } else {\r
        QuestionValue->time.Hour   = EfiTime.Hour;\r
        QuestionValue->time.Minute = EfiTime.Minute;\r
        QuestionValue->time.Second = EfiTime.Second;\r
      }\r
    }\r
\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // Question value is provided by EFI variable\r
  //\r
  StorageWidth = Question->StorageWidth;\r
  if (Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) {\r
    if (Question->BufferValue != NULL) {\r
      Dst = Question->BufferValue;\r
    } else {\r
      Dst = (UINT8 *) QuestionValue;\r
    }\r
\r
    Status = gRT->GetVariable (\r
                     Question->VariableName,\r
                     &Storage->Guid,\r
                     NULL,\r
                     &StorageWidth,\r
                     Dst\r
                     );\r
    //\r
    // Always return success, even this EFI variable doesn't exist\r
    //\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // Question Value is provided by Buffer Storage or NameValue Storage\r
  //\r
  if (Question->BufferValue != NULL) {\r
    //\r
    // This Question is password or orderedlist\r
    //\r
    Dst = Question->BufferValue;\r
  } else {\r
    //\r
    // Other type of Questions\r
    //\r
    Dst = (UINT8 *) &Question->HiiValue.Value;\r
  }\r
\r
  IsBufferStorage = (BOOLEAN) ((Storage->Type == EFI_HII_VARSTORE_BUFFER) ? TRUE : FALSE);\r
  IsString = (BOOLEAN) ((Question->HiiValue.Type == EFI_IFR_TYPE_STRING) ?  TRUE : FALSE);\r
  if (Cached) {\r
    if (IsBufferStorage) {\r
      //\r
      // Copy from storage Edit buffer\r
      //\r
      CopyMem (Dst, Storage->EditBuffer + Question->VarStoreInfo.VarOffset, StorageWidth);\r
    } else {\r
      Value = NULL;\r
      Status = GetValueByName (Storage, Question->VariableName, &Value);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
\r
      ASSERT (Value != NULL);\r
      LengthStr = StrLen (Value);\r
      Status    = EFI_SUCCESS;\r
      if (IsString) {\r
        //\r
        // Convert Config String to Unicode String, e.g "0041004200430044" => "ABCD"\r
        // Add string tail char L'\0' into Length\r
        //\r
        Length    = StorageWidth + sizeof (CHAR16);\r
        if (Length < ((LengthStr / 4 + 1) * 2)) {\r
          Status = EFI_BUFFER_TOO_SMALL;\r
        } else {\r
          StringPtr = (CHAR16 *) Dst;\r
          ZeroMem (TemStr, sizeof (TemStr));\r
          for (Index = 0; Index < LengthStr; Index += 4) {\r
            StrnCpy (TemStr, Value + Index, 4);\r
            StringPtr[Index/4] = (CHAR16) StrHexToUint64 (TemStr);\r
          }\r
          //\r
          // Add tailing L'\0' character\r
          //\r
          StringPtr[Index/4] = L'\0';\r
        }\r
      } else {\r
        if (StorageWidth < ((LengthStr + 1) / 2)) {\r
          Status = EFI_BUFFER_TOO_SMALL;\r
        } else {\r
          ZeroMem (TemStr, sizeof (TemStr));\r
          for (Index = 0; Index < LengthStr; Index ++) {\r
            TemStr[0] = Value[LengthStr - Index - 1];\r
            DigitUint8 = (UINT8) StrHexToUint64 (TemStr);\r
            if ((Index & 1) == 0) {\r
              Dst [Index/2] = DigitUint8;\r
            } else {\r
              Dst [Index/2] = (UINT8) ((DigitUint8 << 4) + Dst [Index/2]);\r
            }\r
          }\r
        }\r
      }\r
\r
      FreePool (Value);\r
    }\r
  } else {\r
    //\r
    // Request current settings from Configuration Driver\r
    //\r
    if (FormSet->ConfigAccess == NULL) {\r
      return EFI_NOT_FOUND;\r
    }\r
\r
    //\r
    // <ConfigRequest> ::= <ConfigHdr> + <BlockName> ||\r
    //                   <ConfigHdr> + "&" + <VariableName>\r
    //\r
    if (IsBufferStorage) {\r
      Length = StrLen (Storage->ConfigHdr);\r
      Length += StrLen (Question->BlockName);\r
    } else {\r
      Length = StrLen (Storage->ConfigHdr);\r
      Length += StrLen (Question->VariableName) + 1;\r
    }\r
    ConfigRequest = AllocateZeroPool ((Length + 1) * sizeof (CHAR16));\r
    ASSERT (ConfigRequest != NULL);\r
\r
    StrCpy (ConfigRequest, Storage->ConfigHdr);\r
    if (IsBufferStorage) {\r
      StrCat (ConfigRequest, Question->BlockName);\r
    } else {\r
      StrCat (ConfigRequest, L"&");\r
      StrCat (ConfigRequest, Question->VariableName);\r
    }\r
\r
    Status = FormSet->ConfigAccess->ExtractConfig (\r
                                      FormSet->ConfigAccess,\r
                                      ConfigRequest,\r
                                      &Progress,\r
                                      &Result\r
                                      );\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    //\r
    // Skip <ConfigRequest>\r
    //\r
    Value = Result + Length;\r
    if (IsBufferStorage) {\r
      //\r
      // Skip "&VALUE"\r
      //\r
      Value = Value + 6;\r
    }\r
    if (*Value != '=') {\r
      FreePool (Result);\r
      return EFI_NOT_FOUND;\r
    }\r
    //\r
    // Skip '=', point to value\r
    //\r
    Value = Value + 1;\r
\r
    //\r
    // Suppress <AltResp> if any\r
    //\r
    StringPtr = Value;\r
    while (*StringPtr != L'\0' && *StringPtr != L'&') {\r
      StringPtr++;\r
    }\r
    *StringPtr = L'\0';\r
\r
    LengthStr = StrLen (Value);\r
    Status    = EFI_SUCCESS;\r
    if (!IsBufferStorage && IsString) {\r
      //\r
      // Convert Config String to Unicode String, e.g "0041004200430044" => "ABCD"\r
      // Add string tail char L'\0' into Length\r
      //\r
      Length    = StorageWidth + sizeof (CHAR16);\r
      if (Length < ((LengthStr / 4 + 1) * 2)) {\r
        Status = EFI_BUFFER_TOO_SMALL;\r
      } else {\r
        StringPtr = (CHAR16 *) Dst;\r
        ZeroMem (TemStr, sizeof (TemStr));\r
        for (Index = 0; Index < LengthStr; Index += 4) {\r
          StrnCpy (TemStr, Value + Index, 4);\r
          StringPtr[Index/4] = (CHAR16) StrHexToUint64 (TemStr);\r
        }\r
        //\r
        // Add tailing L'\0' character\r
        //\r
        StringPtr[Index/4] = L'\0';\r
      }\r
    } else {\r
      if (StorageWidth < ((LengthStr + 1) / 2)) {\r
        Status = EFI_BUFFER_TOO_SMALL;\r
      } else {\r
        ZeroMem (TemStr, sizeof (TemStr));\r
        for (Index = 0; Index < LengthStr; Index ++) {\r
          TemStr[0] = Value[LengthStr - Index - 1];\r
          DigitUint8 = (UINT8) StrHexToUint64 (TemStr);\r
          if ((Index & 1) == 0) {\r
            Dst [Index/2] = DigitUint8;\r
          } else {\r
            Dst [Index/2] = (UINT8) ((DigitUint8 << 4) + Dst [Index/2]);\r
          }\r
        }\r
      }\r
    }\r
\r
    if (EFI_ERROR (Status)) {\r
      FreePool (Result);\r
      return Status;\r
    }\r
\r
    //\r
    // Synchronize Edit Buffer\r
    //\r
    if (IsBufferStorage) {\r
      CopyMem (Storage->EditBuffer + Question->VarStoreInfo.VarOffset, Dst, StorageWidth);\r
    } else {\r
      SetValueByName (Storage, Question->VariableName, Value, TRUE);\r
    }\r
\r
    FreePool (Result);\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Save Question Value to edit copy(cached) or Storage(uncached).\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  Form                   Form data structure.\r
  @param  Question               Pointer to the Question.\r
  @param  Cached                 TRUE:  set to Edit copy FALSE: set to original\r
                                 Storage\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
SetQuestionValue (\r
  IN FORM_BROWSER_FORMSET             *FormSet,\r
  IN FORM_BROWSER_FORM                *Form,\r
  IN OUT FORM_BROWSER_STATEMENT       *Question,\r
  IN BOOLEAN                          Cached\r
  )\r
{\r
  EFI_STATUS          Status;\r
  BOOLEAN             Enabled;\r
  BOOLEAN             Pending;\r
  UINT8               *Src;\r
  EFI_TIME            EfiTime;\r
  UINTN               BufferLen;\r
  UINTN               StorageWidth;\r
  FORMSET_STORAGE     *Storage;\r
  EFI_IFR_TYPE_VALUE  *QuestionValue;\r
  CHAR16              *ConfigResp;\r
  CHAR16              *Progress;\r
  CHAR16              *Value;\r
  UINTN               Length;\r
  BOOLEAN             IsBufferStorage;\r
  BOOLEAN             IsString;\r
  UINT8               *TemBuffer;\r
  CHAR16              *TemName;\r
  CHAR16              *TemString;\r
  UINTN               Index;\r
\r
  Status = EFI_SUCCESS;\r
\r
  //\r
  // Statement don't have storage, skip them\r
  //\r
  if (Question->QuestionId == 0) {\r
    return Status;\r
  }\r
\r
  //\r
  // If Question value is provided by an Expression, then it is read only\r
  //\r
  if (Question->ValueExpression != NULL) {\r
    return Status;\r
  }\r
  \r
  //\r
  // Before set question value, evaluate its write expression.\r
  //\r
  if (Question->WriteExpression != NULL && Form->FormType == STANDARD_MAP_FORM_TYPE) {\r
    Status = EvaluateExpression (FormSet, Form, Question->WriteExpression);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
  }\r
\r
  //\r
  // Question value is provided by RTC\r
  //\r
  Storage = Question->Storage;\r
  QuestionValue = &Question->HiiValue.Value;\r
  if (Storage == NULL) {\r
    //\r
    // It's a Question without storage, or RTC date/time\r
    //\r
    if (Question->Operand == EFI_IFR_DATE_OP || Question->Operand == EFI_IFR_TIME_OP) {\r
      //\r
      // Date and time define the same Flags bit\r
      //\r
      switch (Question->Flags & EFI_QF_DATE_STORAGE) {\r
      case QF_DATE_STORAGE_TIME:\r
        Status = gRT->GetTime (&EfiTime, NULL);\r
        break;\r
\r
      case QF_DATE_STORAGE_WAKEUP:\r
        Status = gRT->GetWakeupTime (&Enabled, &Pending, &EfiTime);\r
        break;\r
\r
      case QF_DATE_STORAGE_NORMAL:\r
      default:\r
        //\r
        // For date/time without storage\r
        //\r
        return EFI_SUCCESS;\r
      }\r
\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
\r
      if (Question->Operand == EFI_IFR_DATE_OP) {\r
        EfiTime.Year  = QuestionValue->date.Year;\r
        EfiTime.Month = QuestionValue->date.Month;\r
        EfiTime.Day   = QuestionValue->date.Day;\r
      } else {\r
        EfiTime.Hour   = QuestionValue->time.Hour;\r
        EfiTime.Minute = QuestionValue->time.Minute;\r
        EfiTime.Second = QuestionValue->time.Second;\r
      }\r
\r
      if ((Question->Flags & EFI_QF_DATE_STORAGE) == QF_DATE_STORAGE_TIME) {\r
        Status = gRT->SetTime (&EfiTime);\r
      } else {\r
        Status = gRT->SetWakeupTime (TRUE, &EfiTime);\r
      }\r
    }\r
\r
    return Status;\r
  }\r
\r
  //\r
  // Question value is provided by EFI variable\r
  //\r
  StorageWidth = Question->StorageWidth;\r
  if (Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) {\r
    if (Question->BufferValue != NULL) {\r
      Src = Question->BufferValue;\r
    } else {\r
      Src = (UINT8 *) QuestionValue;\r
    }\r
\r
    Status = gRT->SetVariable (\r
                     Question->VariableName,\r
                     &Storage->Guid,\r
                     Storage->Attributes,\r
                     StorageWidth,\r
                     Src\r
                     );\r
    return Status;\r
  }\r
\r
  //\r
  // Question Value is provided by Buffer Storage or NameValue Storage\r
  //\r
  if (Question->BufferValue != NULL) {\r
    Src = Question->BufferValue;\r
  } else {\r
    Src = (UINT8 *) &Question->HiiValue.Value;\r
  }\r
\r
  IsBufferStorage = (BOOLEAN) ((Storage->Type == EFI_HII_VARSTORE_BUFFER) ? TRUE : FALSE);\r
  IsString = (BOOLEAN) ((Question->HiiValue.Type == EFI_IFR_TYPE_STRING) ?  TRUE : FALSE);\r
  if (IsBufferStorage) {\r
    //\r
    // Copy to storage edit buffer\r
    //\r
    CopyMem (Storage->EditBuffer + Question->VarStoreInfo.VarOffset, Src, StorageWidth);\r
  } else {\r
    if (IsString) {\r
      //\r
      // Allocate enough string buffer.\r
      //\r
      Value = NULL;\r
      BufferLen = ((StrLen ((CHAR16 *) Src) * 4) + 1) * sizeof (CHAR16);\r
      Value = AllocateZeroPool (BufferLen);\r
      ASSERT (Value != NULL);\r
      //\r
      // Convert Unicode String to Config String, e.g. "ABCD" => "0041004200430044"\r
      //\r
      TemName = (CHAR16 *) Src;\r
      TemString = Value;\r
      for (; *TemName != L'\0'; TemName++) {\r
        TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemName, 4);\r
      }\r
    } else {\r
      BufferLen = StorageWidth * 2 + 1;\r
      Value = AllocateZeroPool (BufferLen * sizeof (CHAR16));\r
      ASSERT (Value != NULL);\r
      //\r
      // Convert Buffer to Hex String\r
      //\r
      TemBuffer = Src + StorageWidth - 1;\r
      TemString = Value;\r
      for (Index = 0; Index < StorageWidth; Index ++, TemBuffer --) {\r
        TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemBuffer, 2);\r
      }\r
    }\r
\r
    Status = SetValueByName (Storage, Question->VariableName, Value, TRUE);\r
    FreePool (Value);\r
  }\r
\r
  if (!Cached) {\r
    //\r
    // <ConfigResp> ::= <ConfigHdr> + <BlockName> + "&VALUE=" + "<HexCh>StorageWidth * 2" ||\r
    //                <ConfigHdr> + "&" + <VariableName> + "=" + "<string>"\r
    //\r
    if (IsBufferStorage) {\r
      Length = StrLen (Question->BlockName) + 7;\r
    } else {\r
      Length = StrLen (Question->VariableName) + 2;\r
    }\r
    if (!IsBufferStorage && IsString) {\r
      Length += (StrLen ((CHAR16 *) Src) * 4);\r
    } else {\r
      Length += (StorageWidth * 2);\r
    }\r
    ConfigResp = AllocateZeroPool ((StrLen (Storage->ConfigHdr) + Length + 1) * sizeof (CHAR16));\r
    ASSERT (ConfigResp != NULL);\r
\r
    StrCpy (ConfigResp, Storage->ConfigHdr);\r
    if (IsBufferStorage) {\r
      StrCat (ConfigResp, Question->BlockName);\r
      StrCat (ConfigResp, L"&VALUE=");\r
    } else {\r
      StrCat (ConfigResp, L"&");\r
      StrCat (ConfigResp, Question->VariableName);\r
      StrCat (ConfigResp, L"=");\r
    }\r
\r
    Value = ConfigResp + StrLen (ConfigResp);\r
\r
    if (!IsBufferStorage && IsString) {\r
      //\r
      // Convert Unicode String to Config String, e.g. "ABCD" => "0041004200430044"\r
      //\r
      TemName = (CHAR16 *) Src;\r
      TemString = Value;\r
      for (; *TemName != L'\0'; TemName++) {\r
        TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemName, 4);\r
      }\r
    } else {\r
      //\r
      // Convert Buffer to Hex String\r
      //\r
      TemBuffer = Src + StorageWidth - 1;\r
      TemString = Value;\r
      for (Index = 0; Index < StorageWidth; Index ++, TemBuffer --) {\r
        TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemBuffer, 2);\r
      }\r
    }\r
\r
    //\r
    // Convert to lower char.\r
    //\r
    for (TemString = Value; *Value != L'\0'; Value++) {\r
      if (*Value >= L'A' && *Value <= L'Z') {\r
        *Value = (CHAR16) (*Value - L'A' + L'a');\r
      }\r
    }\r
\r
    //\r
    // Submit Question Value to Configuration Driver\r
    //\r
    if (FormSet->ConfigAccess != NULL) {\r
      Status = FormSet->ConfigAccess->RouteConfig (\r
                                        FormSet->ConfigAccess,\r
                                        ConfigResp,\r
                                        &Progress\r
                                        );\r
      if (EFI_ERROR (Status)) {\r
        FreePool (ConfigResp);\r
        return Status;\r
      }\r
    }\r
    FreePool (ConfigResp);\r
\r
    //\r
    // Synchronize shadow Buffer\r
    //\r
    SynchronizeStorage (Storage);\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Perform inconsistent check for a Form.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  Form                   Form data structure.\r
  @param  Question               The Question to be validated.\r
  @param  Type                   Validation type: InConsistent or NoSubmit\r
\r
  @retval EFI_SUCCESS            Form validation pass.\r
  @retval other                  Form validation failed.\r
\r
**/\r
EFI_STATUS\r
ValidateQuestion (\r
  IN  FORM_BROWSER_FORMSET            *FormSet,\r
  IN  FORM_BROWSER_FORM               *Form,\r
  IN  FORM_BROWSER_STATEMENT          *Question,\r
  IN  UINTN                           Type\r
  )\r
{\r
  EFI_STATUS              Status;\r
  LIST_ENTRY              *Link;\r
  LIST_ENTRY              *ListHead;\r
  EFI_STRING              PopUp;\r
  EFI_INPUT_KEY           Key;\r
  FORM_EXPRESSION         *Expression;\r
\r
  if (Type == EFI_HII_EXPRESSION_INCONSISTENT_IF) {\r
    ListHead = &Question->InconsistentListHead;\r
  } else if (Type == EFI_HII_EXPRESSION_NO_SUBMIT_IF) {\r
    ListHead = &Question->NoSubmitListHead;\r
  } else {\r
    return EFI_UNSUPPORTED;\r
  }\r
\r
  Link = GetFirstNode (ListHead);\r
  while (!IsNull (ListHead, Link)) {\r
    Expression = FORM_EXPRESSION_FROM_LINK (Link);\r
\r
    //\r
    // Evaluate the expression\r
    //\r
    Status = EvaluateExpression (FormSet, Form, Expression);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    if (Expression->Result.Value.b) {\r
      //\r
      // Condition meet, show up error message\r
      //\r
      if (Expression->Error != 0) {\r
        PopUp = GetToken (Expression->Error, FormSet->HiiHandle);\r
        do {\r
          CreateDialog (4, TRUE, 0, NULL, &Key, gEmptyString, PopUp, gPressEnter, gEmptyString);\r
        } while (Key.UnicodeChar != CHAR_CARRIAGE_RETURN);\r
        FreePool (PopUp);\r
      }\r
\r
      return EFI_NOT_READY;\r
    }\r
\r
    Link = GetNextNode (ListHead, Link);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Perform NoSubmit check for each Form in FormSet.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  CurrentForm            Current input form data structure.\r
\r
  @retval EFI_SUCCESS            Form validation pass.\r
  @retval other                  Form validation failed.\r
\r
**/\r
EFI_STATUS\r
NoSubmitCheck (\r
  IN  FORM_BROWSER_FORMSET            *FormSet,\r
  IN  FORM_BROWSER_FORM               *CurrentForm\r
  )\r
{\r
  EFI_STATUS              Status;\r
  LIST_ENTRY              *Link;\r
  FORM_BROWSER_STATEMENT  *Question;\r
  FORM_BROWSER_FORM       *Form;\r
  LIST_ENTRY              *LinkForm;\r
\r
  LinkForm = GetFirstNode (&FormSet->FormListHead);\r
  while (!IsNull (&FormSet->FormListHead, LinkForm)) {\r
    Form = FORM_BROWSER_FORM_FROM_LINK (LinkForm);\r
    LinkForm = GetNextNode (&FormSet->FormListHead, LinkForm);\r
\r
    if (CurrentForm != NULL && CurrentForm != Form) {\r
      continue;\r
    }\r
\r
    Link = GetFirstNode (&Form->StatementListHead);\r
    while (!IsNull (&Form->StatementListHead, Link)) {\r
      Question = FORM_BROWSER_STATEMENT_FROM_LINK (Link);\r
\r
      Status = ValidateQuestion (FormSet, Form, Question, EFI_HII_EXPRESSION_NO_SUBMIT_IF);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
\r
      Link = GetNextNode (&Form->StatementListHead, Link);\r
    }\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Restore Storage's Edit copy to Shadow copy.\r
\r
  @param  Storage                The Storage to be synchronized.\r
\r
**/\r
VOID\r
RestoreStorage (\r
  IN FORMSET_STORAGE         *Storage\r
  )\r
{\r
  LIST_ENTRY              *Link;\r
  NAME_VALUE_NODE         *Node;\r
\r
  switch (Storage->Type) {\r
  case EFI_HII_VARSTORE_BUFFER:\r
    CopyMem (Storage->EditBuffer, Storage->Buffer, Storage->Size);\r
    break;\r
\r
  case EFI_HII_VARSTORE_NAME_VALUE:\r
    Link = GetFirstNode (&Storage->NameValueListHead);\r
    while (!IsNull (&Storage->NameValueListHead, Link)) {\r
      Node = NAME_VALUE_NODE_FROM_LINK (Link);\r
\r
      if (Node->EditValue != NULL) {\r
        FreePool (Node->EditValue);\r
      }\r
      Node->EditValue = AllocateCopyPool (StrSize (Node->Value), Node->Value);\r
      ASSERT (Node->EditValue != NULL);\r
      Link = GetNextNode (&Storage->NameValueListHead, Link);\r
    }\r
    break;\r
\r
  case EFI_HII_VARSTORE_EFI_VARIABLE:\r
  default:\r
    break;\r
  }\r
}\r
\r
/**\r
  Fill storage's edit copy with settings requested from Configuration Driver.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  ConfigInfo             The config info related to this form.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
FormRestoreStorage (\r
  IN FORM_BROWSER_FORMSET        *FormSet,\r
  IN FORM_BROWSER_CONFIG_REQUEST *ConfigInfo\r
  )\r
{\r
  EFI_STATUS              Status;\r
  EFI_STRING              Progress;\r
  EFI_STRING              Result;\r
  UINTN                   BufferSize;\r
  LIST_ENTRY              *Link;\r
  NAME_VALUE_NODE         *Node;\r
\r
  Status = EFI_SUCCESS;\r
  Result = NULL;\r
  if (FormSet->ConfigAccess == NULL) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  if (ConfigInfo->ElementCount == 0) {\r
    //\r
    // Skip if there is no RequestElement\r
    //\r
    return EFI_SUCCESS;\r
  }\r
\r
  if (ConfigInfo->Storage->Type == EFI_HII_VARSTORE_BUFFER) {\r
    BufferSize = ConfigInfo->Storage->Size;\r
    Status = mHiiConfigRouting->BlockToConfig(\r
                                  mHiiConfigRouting,\r
                                  ConfigInfo->ConfigRequest,\r
                                  ConfigInfo->Storage->Buffer,\r
                                  BufferSize,\r
                                  &Result,\r
                                  &Progress\r
                                  );\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    Status = mHiiConfigRouting->ConfigToBlock (\r
                                  mHiiConfigRouting,\r
                                  Result,\r
                                  ConfigInfo->Storage->EditBuffer,\r
                                  &BufferSize,\r
                                  &Progress\r
                                  );\r
    if (Result != NULL) {\r
      FreePool (Result);\r
    }\r
\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
  } else if (ConfigInfo->Storage->Type == EFI_HII_VARSTORE_NAME_VALUE) {\r
    Link = GetFirstNode (&ConfigInfo->Storage->NameValueListHead);\r
    while (!IsNull (&ConfigInfo->Storage->NameValueListHead, Link)) {\r
      Node = NAME_VALUE_NODE_FROM_LINK (Link);\r
\r
      if (StrStr (ConfigInfo->ConfigRequest, Node->Name) != NULL) {\r
        if (Node->EditValue != NULL) {\r
          FreePool (Node->EditValue);\r
        }\r
        Node->EditValue = AllocateCopyPool (StrSize (Node->Value), Node->Value);\r
        ASSERT (Node->EditValue != NULL);\r
      }\r
\r
      Link = GetNextNode (&ConfigInfo->Storage->NameValueListHead, Link);\r
    }\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Discard data for form level or formset level.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  Form                   Form data structure.\r
  @param  SingleForm             Only discard single form or formset.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
DiscardForm (\r
  IN FORM_BROWSER_FORMSET             *FormSet,\r
  IN FORM_BROWSER_FORM                *Form,\r
  IN BOOLEAN                          SingleForm\r
  )\r
{\r
  LIST_ENTRY              *Link;\r
  FORMSET_STORAGE         *Storage;\r
  FORM_BROWSER_CONFIG_REQUEST  *ConfigInfo;\r
\r
  if (SingleForm) {\r
    if (Form->NvUpdateRequired) {\r
      ConfigInfo = NULL;\r
      Link = GetFirstNode (&Form->ConfigRequestHead);\r
      while (!IsNull (&Form->ConfigRequestHead, Link)) {\r
        ConfigInfo = FORM_BROWSER_CONFIG_REQUEST_FROM_LINK (Link);\r
        Link = GetNextNode (&Form->ConfigRequestHead, Link);\r
\r
        if (ConfigInfo->Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) {\r
          continue;\r
        }\r
\r
        //\r
        // Skip if there is no RequestElement\r
        //\r
        if (ConfigInfo->ElementCount == 0) {\r
          continue;\r
        }\r
\r
        //\r
        // Prepare <ConfigResp>\r
        //\r
        FormRestoreStorage(FormSet, ConfigInfo);\r
      }\r
\r
      Form->NvUpdateRequired = FALSE;\r
    }\r
  } else {\r
    if (IsNvUpdateRequired(FormSet)) {\r
      //\r
      // Discard Buffer storage or Name/Value storage\r
      //\r
      Link = GetFirstNode (&FormSet->StorageListHead);\r
      while (!IsNull (&FormSet->StorageListHead, Link)) {\r
        Storage = FORMSET_STORAGE_FROM_LINK (Link);\r
        Link = GetNextNode (&FormSet->StorageListHead, Link);\r
\r
        if (Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) {\r
          continue;\r
        }\r
\r
        //\r
        // Skip if there is no RequestElement\r
        //\r
        if (Storage->ElementCount == 0) {\r
          continue;\r
        }\r
\r
        RestoreStorage(Storage);\r
      }\r
\r
      UpdateNvInfoInForm(FormSet, FALSE);   \r
    }\r
  }\r
\r
  return EFI_SUCCESS;  \r
}\r
\r
/**\r
  Submit data for form level or formset level.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  Form                   Form data structure.\r
  @param  SingleForm             whether submit for the single form or all form set.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
SubmitForm (\r
  IN FORM_BROWSER_FORMSET             *FormSet,\r
  IN FORM_BROWSER_FORM                *Form,\r
  IN BOOLEAN                          SingleForm\r
  )\r
{\r
  EFI_STATUS              Status;\r
  LIST_ENTRY              *Link;\r
  EFI_STRING              ConfigResp;\r
  EFI_STRING              Progress;\r
  FORMSET_STORAGE         *Storage;\r
  FORM_BROWSER_CONFIG_REQUEST  *ConfigInfo;\r
\r
  //\r
  // Validate the Form by NoSubmit check\r
  //\r
  if (SingleForm) {\r
    Status = NoSubmitCheck (FormSet, Form);\r
  } else {\r
    Status = NoSubmitCheck (FormSet, NULL);\r
  }\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  if (SingleForm) {\r
    ConfigInfo = NULL;\r
    Link = GetFirstNode (&Form->ConfigRequestHead);\r
    while (!IsNull (&Form->ConfigRequestHead, Link)) {\r
      ConfigInfo = FORM_BROWSER_CONFIG_REQUEST_FROM_LINK (Link);\r
      Link = GetNextNode (&Form->ConfigRequestHead, Link);\r
\r
      if (ConfigInfo->Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) {\r
        continue;\r
      }\r
\r
      //\r
      // Skip if there is no RequestElement\r
      //\r
      if (ConfigInfo->ElementCount == 0) {\r
        continue;\r
      }\r
\r
      //\r
      // Prepare <ConfigResp>\r
      //\r
      Status = StorageToConfigResp (ConfigInfo, &ConfigResp, TRUE);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
\r
      //\r
      // Send <ConfigResp> to Configuration Driver\r
      //\r
      if (FormSet->ConfigAccess != NULL) {\r
        Status = FormSet->ConfigAccess->RouteConfig (\r
                                          FormSet->ConfigAccess,\r
                                          ConfigResp,\r
                                          &Progress\r
                                          );\r
        if (EFI_ERROR (Status)) {\r
          FreePool (ConfigResp);\r
          return Status;\r
        }\r
      }\r
      FreePool (ConfigResp);\r
\r
      //\r
      // Config success, update storage shadow Buffer\r
      //\r
      SynchronizeStorage (ConfigInfo->Storage);\r
    }\r
\r
    Form->NvUpdateRequired = FALSE;\r
  } else {\r
    //\r
    // Submit Buffer storage or Name/Value storage\r
    //\r
    Link = GetFirstNode (&FormSet->StorageListHead);\r
    while (!IsNull (&FormSet->StorageListHead, Link)) {\r
      Storage = FORMSET_STORAGE_FROM_LINK (Link);\r
      Link = GetNextNode (&FormSet->StorageListHead, Link);\r
\r
      if (Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) {\r
        continue;\r
      }\r
\r
      //\r
      // Skip if there is no RequestElement\r
      //\r
      if (Storage->ElementCount == 0) {\r
        continue;\r
      }\r
\r
      //\r
      // Prepare <ConfigResp>\r
      //\r
      Status = StorageToConfigResp (Storage, &ConfigResp, FALSE);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
\r
      //\r
      // Send <ConfigResp> to Configuration Driver\r
      //\r
      if (FormSet->ConfigAccess != NULL) {\r
        Status = FormSet->ConfigAccess->RouteConfig (\r
                                          FormSet->ConfigAccess,\r
                                          ConfigResp,\r
                                          &Progress\r
                                          );\r
        if (EFI_ERROR (Status)) {\r
          FreePool (ConfigResp);\r
          return Status;\r
        }\r
      }\r
      FreePool (ConfigResp);\r
\r
      //\r
      // Config success, update storage shadow Buffer\r
      //\r
      SynchronizeStorage (Storage);\r
    }\r
\r
    UpdateNvInfoInForm(FormSet, FALSE);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Get Question default value from AltCfg string.\r
\r
  @param  FormSet                The form set.\r
  @param  Question               The question.\r
  @param  DefaultId              The default Id.\r
\r
  @retval EFI_SUCCESS            Question is reset to default value.\r
\r
**/\r
EFI_STATUS\r
GetDefaultValueFromAltCfg (\r
  IN     FORM_BROWSER_FORMSET             *FormSet,\r
  IN OUT FORM_BROWSER_STATEMENT           *Question,\r
  IN     UINT16                           DefaultId\r
  )\r
{\r
  BOOLEAN             IsBufferStorage;\r
  BOOLEAN             IsString;  \r
  UINTN               Length;\r
  FORMSET_STORAGE     *Storage;\r
  CHAR16              *ConfigRequest;\r
  CHAR16              *Progress;\r
  CHAR16              *Result;\r
  CHAR16              *ConfigResp;\r
  CHAR16              *Value;\r
  CHAR16              *StringPtr;\r
  UINTN               LengthStr;\r
  UINT8               *Dst;\r
  CHAR16              TemStr[5];\r
  UINTN               Index;\r
  UINT8               DigitUint8;\r
  EFI_STATUS          Status;\r
\r
  Status        = EFI_NOT_FOUND;\r
  Length        = 0;\r
  Dst           = NULL;\r
  ConfigRequest = NULL;\r
  Result        = NULL;\r
  ConfigResp    = NULL;\r
  Value         = NULL;\r
  Storage       = Question->Storage;\r
\r
  if ((Storage == NULL) || (Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Question Value is provided by Buffer Storage or NameValue Storage\r
  //\r
  if (Question->BufferValue != NULL) {\r
    //\r
    // This Question is password or orderedlist\r
    //\r
    Dst = Question->BufferValue;\r
  } else {\r
    //\r
    // Other type of Questions\r
    //\r
    Dst = (UINT8 *) &Question->HiiValue.Value;\r
  }\r
\r
  IsBufferStorage = (BOOLEAN) ((Storage->Type == EFI_HII_VARSTORE_BUFFER) ? TRUE : FALSE);\r
  IsString = (BOOLEAN) ((Question->HiiValue.Type == EFI_IFR_TYPE_STRING) ?  TRUE : FALSE);\r
\r
  //\r
  // <ConfigRequest> ::= <ConfigHdr> + <BlockName> ||\r
  //                   <ConfigHdr> + "&" + <VariableName>\r
  //\r
  if (IsBufferStorage) {\r
    Length  = StrLen (Storage->ConfigHdr);\r
    Length += StrLen (Question->BlockName);\r
  } else {\r
    Length  = StrLen (Storage->ConfigHdr);\r
    Length += StrLen (Question->VariableName) + 1;\r
  }\r
  ConfigRequest = AllocateZeroPool ((Length + 1) * sizeof (CHAR16));\r
  ASSERT (ConfigRequest != NULL);\r
\r
  StrCpy (ConfigRequest, Storage->ConfigHdr);\r
  if (IsBufferStorage) {\r
    StrCat (ConfigRequest, Question->BlockName);\r
  } else {\r
    StrCat (ConfigRequest, L"&");\r
    StrCat (ConfigRequest, Question->VariableName);\r
  }\r
\r
  Status = FormSet->ConfigAccess->ExtractConfig (\r
                                    FormSet->ConfigAccess,\r
                                    ConfigRequest,\r
                                    &Progress,\r
                                    &Result\r
                                    );\r
  if (EFI_ERROR (Status)) {\r
    goto Done;\r
  }\r
\r
  //\r
  // Call ConfigRouting GetAltCfg(ConfigRoute, <ConfigResponse>, Guid, Name, DevicePath, AltCfgId, AltCfgResp)\r
  //    Get the default configuration string according to the default ID.\r
  //\r
  Status = mHiiConfigRouting->GetAltConfig (\r
                                mHiiConfigRouting,\r
                                Result,\r
                                &Storage->Guid,\r
                                Storage->Name,\r
                                NULL,\r
                                &DefaultId,  // it can be NULL to get the current setting.\r
                                &ConfigResp\r
                              );\r
  \r
  //\r
  // The required setting can't be found. So, it is not required to be validated and set.\r
  //\r
  if (EFI_ERROR (Status)) {\r
    goto Done;\r
  }\r
\r
  //\r
  // Skip <ConfigRequest>\r
  //\r
  if (IsBufferStorage) {\r
    Value = StrStr (ConfigResp, L"&VALUE");\r
    ASSERT (Value != NULL);\r
    //\r
    // Skip "&VALUE"\r
    //\r
    Value = Value + 6;\r
  } else {\r
    Value = StrStr (ConfigResp, Question->VariableName);\r
    ASSERT (Value != NULL);\r
\r
    Value = Value + StrLen (Question->VariableName);\r
  }\r
  if (*Value != '=') {\r
    Status = EFI_NOT_FOUND;\r
    goto Done;\r
  }\r
  //\r
  // Skip '=', point to value\r
  //\r
  Value = Value + 1;\r
\r
  //\r
  // Suppress <AltResp> if any\r
  //\r
  StringPtr = Value;\r
  while (*StringPtr != L'\0' && *StringPtr != L'&') {\r
    StringPtr++;\r
  }\r
  *StringPtr = L'\0';\r
\r
  LengthStr = StrLen (Value);\r
  if (!IsBufferStorage && IsString) {\r
    StringPtr = (CHAR16 *) Dst;\r
    ZeroMem (TemStr, sizeof (TemStr));\r
    for (Index = 0; Index < LengthStr; Index += 4) {\r
      StrnCpy (TemStr, Value + Index, 4);\r
      StringPtr[Index/4] = (CHAR16) StrHexToUint64 (TemStr);\r
    }\r
    //\r
    // Add tailing L'\0' character\r
    //\r
    StringPtr[Index/4] = L'\0';\r
  } else {\r
    ZeroMem (TemStr, sizeof (TemStr));\r
    for (Index = 0; Index < LengthStr; Index ++) {\r
      TemStr[0] = Value[LengthStr - Index - 1];\r
      DigitUint8 = (UINT8) StrHexToUint64 (TemStr);\r
      if ((Index & 1) == 0) {\r
        Dst [Index/2] = DigitUint8;\r
      } else {\r
        Dst [Index/2] = (UINT8) ((DigitUint8 << 4) + Dst [Index/2]);\r
      }\r
    }\r
  }\r
\r
Done:\r
  if (ConfigRequest != NULL){\r
    FreePool (ConfigRequest);\r
  }\r
\r
  if (ConfigResp != NULL) {\r
    FreePool (ConfigResp);\r
  }\r
  \r
  if (Result != NULL) {\r
    FreePool (Result);\r
  }\r
\r
  return Status;\r
}\r
\r
/**\r
  Get default Id value used for browser.\r
\r
  @param  DefaultId              The default id value used by hii.\r
\r
  @retval Browser used default value.\r
\r
**/\r
INTN\r
GetDefaultIdForCallBack (\r
  UINTN DefaultId\r
  )\r
{ \r
  if (DefaultId == EFI_HII_DEFAULT_CLASS_STANDARD) {\r
    return EFI_BROWSER_ACTION_DEFAULT_STANDARD;\r
  } else if (DefaultId == EFI_HII_DEFAULT_CLASS_MANUFACTURING) {\r
    return EFI_BROWSER_ACTION_DEFAULT_MANUFACTURING;\r
  } else if (DefaultId == EFI_HII_DEFAULT_CLASS_SAFE) {\r
    return EFI_BROWSER_ACTION_DEFAULT_SAFE;\r
  } else if (DefaultId >= EFI_HII_DEFAULT_CLASS_PLATFORM_BEGIN && DefaultId < EFI_HII_DEFAULT_CLASS_PLATFORM_BEGIN + 0x1000) {\r
    return EFI_BROWSER_ACTION_DEFAULT_PLATFORM + DefaultId - EFI_HII_DEFAULT_CLASS_PLATFORM_BEGIN;\r
  } else if (DefaultId >= EFI_HII_DEFAULT_CLASS_HARDWARE_BEGIN && DefaultId < EFI_HII_DEFAULT_CLASS_HARDWARE_BEGIN + 0x1000) {\r
    return EFI_BROWSER_ACTION_DEFAULT_HARDWARE + DefaultId - EFI_HII_DEFAULT_CLASS_HARDWARE_BEGIN;\r
  } else if (DefaultId >= EFI_HII_DEFAULT_CLASS_FIRMWARE_BEGIN && DefaultId < EFI_HII_DEFAULT_CLASS_FIRMWARE_BEGIN + 0x1000) {\r
    return EFI_BROWSER_ACTION_DEFAULT_FIRMWARE + DefaultId - EFI_HII_DEFAULT_CLASS_FIRMWARE_BEGIN;\r
  } else {\r
    return -1;\r
  }\r
}\r
\r
/**\r
  Reset Question to its default value.\r
\r
  @param  FormSet                The form set.\r
  @param  Form                   The form.\r
  @param  Question               The question.\r
  @param  DefaultId              The Class of the default.\r
\r
  @retval EFI_SUCCESS            Question is reset to default value.\r
\r
**/\r
EFI_STATUS\r
GetQuestionDefault (\r
  IN FORM_BROWSER_FORMSET             *FormSet,\r
  IN FORM_BROWSER_FORM                *Form,\r
  IN FORM_BROWSER_STATEMENT           *Question,\r
  IN UINT16                           DefaultId\r
  )\r
{\r
  EFI_STATUS              Status;\r
  LIST_ENTRY              *Link;\r
  QUESTION_DEFAULT        *Default;\r
  QUESTION_OPTION         *Option;\r
  EFI_HII_VALUE           *HiiValue;\r
  UINT8                   Index;\r
  EFI_STRING              StrValue;\r
  EFI_HII_CONFIG_ACCESS_PROTOCOL  *ConfigAccess;\r
  EFI_BROWSER_ACTION_REQUEST      ActionRequest;\r
  INTN                            Action;\r
\r
  Status   = EFI_SUCCESS;\r
  StrValue = NULL;\r
\r
  //\r
  // Statement don't have storage, skip them\r
  //\r
  if (Question->QuestionId == 0) {\r
    return Status;\r
  }\r
\r
  //\r
  // There are Five ways to specify default value for a Question:\r
  //  1, use call back function (highest priority)\r
  //  2, use ExtractConfig function\r
  //  3, use nested EFI_IFR_DEFAULT \r
  //  4, set flags of EFI_ONE_OF_OPTION (provide Standard and Manufacturing default)\r
  //  5, set flags of EFI_IFR_CHECKBOX (provide Standard and Manufacturing default) (lowest priority)\r
  //\r
  HiiValue = &Question->HiiValue;\r
\r
  //\r
  // Get Question defaut value from call back function.\r
  //\r
  ConfigAccess = FormSet->ConfigAccess;\r
  Action = GetDefaultIdForCallBack (DefaultId);\r
  if ((Action > 0) && ((Question->QuestionFlags & EFI_IFR_FLAG_CALLBACK) != 0) && (ConfigAccess != NULL)) {\r
    ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
    Status = ConfigAccess->Callback (\r
                             ConfigAccess,\r
                             Action,\r
                             Question->QuestionId,\r
                             HiiValue->Type,\r
                             &HiiValue->Value,\r
                             &ActionRequest\r
                             );\r
    if (!EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
  }\r
\r
  //\r
  // Get default value from altcfg string.\r
  //\r
  if (ConfigAccess != NULL) {  \r
    Status = GetDefaultValueFromAltCfg(FormSet, Question, DefaultId);\r
    if (!EFI_ERROR (Status)) {\r
        return Status;\r
    }\r
  }\r
\r
  //\r
  // EFI_IFR_DEFAULT has highest priority\r
  //\r
  if (!IsListEmpty (&Question->DefaultListHead)) {\r
    Link = GetFirstNode (&Question->DefaultListHead);\r
    while (!IsNull (&Question->DefaultListHead, Link)) {\r
      Default = QUESTION_DEFAULT_FROM_LINK (Link);\r
\r
      if (Default->DefaultId == DefaultId) {\r
        if (Default->ValueExpression != NULL) {\r
          //\r
          // Default is provided by an Expression, evaluate it\r
          //\r
          Status = EvaluateExpression (FormSet, Form, Default->ValueExpression);\r
          if (EFI_ERROR (Status)) {\r
            return Status;\r
          }\r
\r
          CopyMem (HiiValue, &Default->ValueExpression->Result, sizeof (EFI_HII_VALUE));\r
        } else {\r
          //\r
          // Default value is embedded in EFI_IFR_DEFAULT\r
          //\r
          CopyMem (HiiValue, &Default->Value, sizeof (EFI_HII_VALUE));\r
        }\r
\r
        if (HiiValue->Type == EFI_IFR_TYPE_STRING) {\r
          StrValue = HiiGetString (FormSet->HiiHandle, HiiValue->Value.string, NULL);\r
          if (StrValue == NULL) {\r
            return EFI_NOT_FOUND;\r
          }\r
          Question->BufferValue = AllocateCopyPool (StrSize (StrValue), StrValue);\r
        }\r
\r
        return EFI_SUCCESS;\r
      }\r
\r
      Link = GetNextNode (&Question->DefaultListHead, Link);\r
    }\r
  }\r
\r
  //\r
  // EFI_ONE_OF_OPTION\r
  //\r
  if ((Question->Operand == EFI_IFR_ONE_OF_OP) && !IsListEmpty (&Question->OptionListHead)) {\r
    if (DefaultId <= EFI_HII_DEFAULT_CLASS_MANUFACTURING)  {\r
      //\r
      // OneOfOption could only provide Standard and Manufacturing default\r
      //\r
      Link = GetFirstNode (&Question->OptionListHead);\r
      while (!IsNull (&Question->OptionListHead, Link)) {\r
        Option = QUESTION_OPTION_FROM_LINK (Link);\r
\r
        if (((DefaultId == EFI_HII_DEFAULT_CLASS_STANDARD) && ((Option->Flags & EFI_IFR_OPTION_DEFAULT) != 0)) ||\r
            ((DefaultId == EFI_HII_DEFAULT_CLASS_MANUFACTURING) && ((Option->Flags & EFI_IFR_OPTION_DEFAULT_MFG) != 0))\r
           ) {\r
          CopyMem (HiiValue, &Option->Value, sizeof (EFI_HII_VALUE));\r
\r
          return EFI_SUCCESS;\r
        }\r
\r
        Link = GetNextNode (&Question->OptionListHead, Link);\r
      }\r
    }\r
  }\r
\r
  //\r
  // EFI_IFR_CHECKBOX - lowest priority\r
  //\r
  if (Question->Operand == EFI_IFR_CHECKBOX_OP) {\r
    if (DefaultId <= EFI_HII_DEFAULT_CLASS_MANUFACTURING)  {\r
      //\r
      // Checkbox could only provide Standard and Manufacturing default\r
      //\r
      if (((DefaultId == EFI_HII_DEFAULT_CLASS_STANDARD) && ((Question->Flags & EFI_IFR_CHECKBOX_DEFAULT) != 0)) ||\r
          ((DefaultId == EFI_HII_DEFAULT_CLASS_MANUFACTURING) && ((Question->Flags & EFI_IFR_CHECKBOX_DEFAULT_MFG) != 0))\r
         ) {\r
        HiiValue->Value.b = TRUE;\r
      } else {\r
        HiiValue->Value.b = FALSE;\r
      }\r
\r
      return EFI_SUCCESS;\r
    }\r
  }\r
\r
  //\r
  // For Questions without default\r
  //\r
  switch (Question->Operand) {\r
  case EFI_IFR_NUMERIC_OP:\r
    //\r
    // Take minimum value as numeric default value\r
    //\r
    if ((HiiValue->Value.u64 < Question->Minimum) || (HiiValue->Value.u64 > Question->Maximum)) {\r
      HiiValue->Value.u64 = Question->Minimum;\r
    }\r
    break;\r
\r
  case EFI_IFR_ONE_OF_OP:\r
    //\r
    // Take first oneof option as oneof's default value\r
    //\r
    if (ValueToOption (Question, HiiValue) == NULL) {\r
      Link = GetFirstNode (&Question->OptionListHead);\r
      if (!IsNull (&Question->OptionListHead, Link)) {\r
        Option = QUESTION_OPTION_FROM_LINK (Link);\r
        CopyMem (HiiValue, &Option->Value, sizeof (EFI_HII_VALUE));\r
      }\r
    }\r
    break;\r
\r
  case EFI_IFR_ORDERED_LIST_OP:\r
    //\r
    // Take option sequence in IFR as ordered list's default value\r
    //\r
    Index = 0;\r
    Link = GetFirstNode (&Question->OptionListHead);\r
    while (!IsNull (&Question->OptionListHead, Link)) {\r
      Option = QUESTION_OPTION_FROM_LINK (Link);\r
\r
      SetArrayData (Question->BufferValue, Question->ValueType, Index, Option->Value.Value.u64);\r
\r
      Index++;\r
      if (Index >= Question->MaxContainers) {\r
        break;\r
      }\r
\r
      Link = GetNextNode (&Question->OptionListHead, Link);\r
    }\r
    break;\r
\r
  default:\r
    Status = EFI_NOT_FOUND;\r
    break;\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Reset Questions in a Formset to their default value.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  DefaultId              The Class of the default.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
ExtractFormSetDefault (\r
  IN FORM_BROWSER_FORMSET             *FormSet,\r
  IN UINT16                           DefaultId\r
  )\r
{\r
  EFI_STATUS              Status;\r
  LIST_ENTRY              *FormLink;\r
  LIST_ENTRY              *StatementLink;\r
  FORM_BROWSER_STATEMENT  *Question;\r
  FORM_BROWSER_FORM       *Form;\r
\r
  FormLink = GetFirstNode (&FormSet->FormListHead);\r
  while (!IsNull (&FormSet->FormListHead, FormLink)) {\r
    Form = FORM_BROWSER_FORM_FROM_LINK (FormLink); \r
    \r
    //\r
    // Extract Form default\r
    //\r
    StatementLink = GetFirstNode (&Form->StatementListHead);\r
    while (!IsNull (&Form->StatementListHead, StatementLink)) {\r
      Question = FORM_BROWSER_STATEMENT_FROM_LINK (StatementLink);\r
      StatementLink = GetNextNode (&Form->StatementListHead, StatementLink);\r
\r
      //\r
      // If Question is disabled, don't reset it to default\r
      //\r
      if (Question->DisableExpression != NULL) {\r
        Status = EvaluateExpression (FormSet, Form, Question->DisableExpression);\r
        if (!EFI_ERROR (Status) && Question->DisableExpression->Result.Value.b) {\r
          continue;\r
        }\r
      }\r
\r
      //\r
      // Reset Question to its default value\r
      //\r
      Status = GetQuestionDefault (FormSet, Form, Question, DefaultId);\r
      if (EFI_ERROR (Status)) {\r
        continue;\r
      }\r
\r
      //\r
      // Synchronize Buffer storage's Edit buffer\r
      //\r
      if ((Question->Storage != NULL) &&\r
          (Question->Storage->Type != EFI_HII_VARSTORE_EFI_VARIABLE)) {\r
        SetQuestionValue (FormSet, Form, Question, TRUE);\r
      }\r
    }\r
    FormLink = GetNextNode (&FormSet->FormListHead, FormLink);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Initialize Question's Edit copy from Storage.\r
\r
  @param  Selection              Selection contains the information about \r
                                 the Selection, form and formset to be displayed.\r
                                 Selection action may be updated in retrieve callback.\r
  @param  FormSet                FormSet data structure.\r
  @param  Form                   Form data structure.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
LoadFormConfig (\r
  IN OUT UI_MENU_SELECTION    *Selection,\r
  IN FORM_BROWSER_FORMSET     *FormSet,\r
  IN FORM_BROWSER_FORM        *Form\r
  )\r
{\r
  EFI_STATUS                  Status;\r
  LIST_ENTRY                  *Link;\r
  FORM_BROWSER_STATEMENT      *Question;\r
  UINT8                       *BufferValue;\r
  UINTN                       StorageWidth;\r
  \r
  Link = GetFirstNode (&Form->StatementListHead);\r
  while (!IsNull (&Form->StatementListHead, Link)) {\r
    Question = FORM_BROWSER_STATEMENT_FROM_LINK (Link);\r
\r
    //\r
    // Initialize local copy of Value for each Question\r
    //\r
    Status = GetQuestionValue (FormSet, Form, Question, TRUE);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    if ((Question->Operand == EFI_IFR_STRING_OP) || (Question->Operand == EFI_IFR_PASSWORD_OP)) {\r
      HiiSetString (FormSet->HiiHandle, Question->HiiValue.Value.string, (CHAR16*)Question->BufferValue, NULL);\r
    }\r
\r
    //\r
    // According the spec, ref opcode try to get value from call back with "retrieve" type.\r
    //\r
    if ((Question->Operand == EFI_IFR_REF_OP) && (FormSet->ConfigAccess != NULL)) {\r
      Status = ProcessCallBackFunction(Selection, Question, EFI_BROWSER_ACTION_RETRIEVE, TRUE);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
    }\r
\r
    //\r
    // Check whether EfiVarstore with CallBack can be got.\r
    //\r
    if ((FormSet->ConfigAccess != NULL) &&\r
        (Selection->Action != UI_ACTION_REFRESH_FORMSET) &&\r
        (Question->QuestionId != 0) && \r
        (Question->Storage != NULL) &&\r
        (Question->Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) && \r
        ((Question->QuestionFlags & EFI_IFR_FLAG_CALLBACK) == EFI_IFR_FLAG_CALLBACK)) {\r
\r
      //\r
      // Check QuestionValue does exist.\r
      //\r
      StorageWidth = Question->StorageWidth;\r
      if (Question->BufferValue != NULL) {\r
        BufferValue  = Question->BufferValue;\r
      } else {\r
        BufferValue = (UINT8 *) &Question->HiiValue.Value;\r
      }\r
      Status = gRT->GetVariable (\r
                       Question->VariableName,\r
                       &Question->Storage->Guid,\r
                       NULL,\r
                       &StorageWidth,\r
                       BufferValue\r
                       );\r
\r
      if (!EFI_ERROR (Status)) {\r
        Status = ProcessCallBackFunction(Selection, Question, EFI_BROWSER_ACTION_RETRIEVE, TRUE);\r
      }\r
    }\r
\r
    Link = GetNextNode (&Form->StatementListHead, Link);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Initialize Question's Edit copy from Storage for the whole Formset.\r
\r
  @param  Selection              Selection contains the information about \r
                                 the Selection, form and formset to be displayed.\r
                                 Selection action may be updated in retrieve callback.\r
  @param  FormSet                FormSet data structure.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
LoadFormSetConfig (\r
  IN OUT UI_MENU_SELECTION    *Selection,\r
  IN     FORM_BROWSER_FORMSET *FormSet\r
  )\r
{\r
  EFI_STATUS            Status;\r
  LIST_ENTRY            *Link;\r
  FORM_BROWSER_FORM     *Form;\r
\r
  Link = GetFirstNode (&FormSet->FormListHead);\r
  while (!IsNull (&FormSet->FormListHead, Link)) {\r
    Form = FORM_BROWSER_FORM_FROM_LINK (Link);\r
\r
    //\r
    // Initialize local copy of Value for each Form\r
    //\r
    Status = LoadFormConfig (Selection, FormSet, Form);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    Link = GetNextNode (&FormSet->FormListHead, Link);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Fill storage's edit copy with settings requested from Configuration Driver.\r
\r
  @param  FormSet                FormSet data structure.\r
  @param  Storage                Buffer Storage.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
LoadStorage (\r
  IN FORM_BROWSER_FORMSET    *FormSet,\r
  IN FORMSET_STORAGE         *Storage\r
  )\r
{\r
  EFI_STATUS  Status;\r
  EFI_STRING  Progress;\r
  EFI_STRING  Result;\r
  CHAR16      *StrPtr;\r
\r
  if (Storage->Type == EFI_HII_VARSTORE_EFI_VARIABLE) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  if (FormSet->ConfigAccess == NULL) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  if (Storage->ElementCount == 0) {\r
    //\r
    // Skip if there is no RequestElement\r
    //\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // Request current settings from Configuration Driver\r
  //\r
  Status = FormSet->ConfigAccess->ExtractConfig (\r
                                    FormSet->ConfigAccess,\r
                                    Storage->ConfigRequest,\r
                                    &Progress,\r
                                    &Result\r
                                    );\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Convert Result from <ConfigAltResp> to <ConfigResp>\r
  //\r
  StrPtr = StrStr (Result, L"ALTCFG");\r
  if (StrPtr != NULL) {\r
    *StrPtr = L'\0';\r
  }\r
\r
  Status = ConfigRespToStorage (Storage, Result);\r
  FreePool (Result);\r
  return Status;\r
}\r
\r
\r
/**\r
  Copy uncommitted data from source Storage to destination Storage.\r
\r
  @param  Dst                    Target Storage for uncommitted data.\r
  @param  Src                    Source Storage for uncommitted data.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
  @retval EFI_INVALID_PARAMETER  Source and destination Storage is not the same type.\r
\r
**/\r
EFI_STATUS\r
CopyStorage (\r
  IN OUT FORMSET_STORAGE     *Dst,\r
  IN FORMSET_STORAGE         *Src\r
  )\r
{\r
  LIST_ENTRY          *Link;\r
  NAME_VALUE_NODE     *Node;\r
\r
  if ((Dst->Type != Src->Type) || (Dst->Size != Src->Size)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  switch (Src->Type) {\r
  case EFI_HII_VARSTORE_BUFFER:\r
    CopyMem (Dst->EditBuffer, Src->EditBuffer, Src->Size);\r
    CopyMem (Dst->Buffer, Src->Buffer, Src->Size);\r
    break;\r
\r
  case EFI_HII_VARSTORE_NAME_VALUE:\r
    Link = GetFirstNode (&Src->NameValueListHead);\r
    while (!IsNull (&Src->NameValueListHead, Link)) {\r
      Node = NAME_VALUE_NODE_FROM_LINK (Link);\r
\r
      SetValueByName (Dst, Node->Name, Node->EditValue, TRUE);\r
      SetValueByName (Dst, Node->Name, Node->Value, FALSE);\r
\r
      Link = GetNextNode (&Src->NameValueListHead, Link);\r
    }\r
    break;\r
\r
  case EFI_HII_VARSTORE_EFI_VARIABLE:\r
  default:\r
    break;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Get current setting of Questions.\r
\r
  @param  FormSet                FormSet data structure.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
\r
**/\r
EFI_STATUS\r
InitializeCurrentSetting (\r
  IN OUT FORM_BROWSER_FORMSET             *FormSet\r
  )\r
{\r
  LIST_ENTRY              *Link;\r
  LIST_ENTRY              *Link2;\r
  FORMSET_STORAGE         *Storage;\r
  FORMSET_STORAGE         *StorageSrc;\r
  FORMSET_STORAGE         *OldStorage;\r
  FORM_BROWSER_FORM       *Form;\r
  FORM_BROWSER_FORM       *Form2;\r
  EFI_STATUS              Status;\r
\r
  //\r
  // Extract default from IFR binary\r
  //\r
  Status = ExtractFormSetDefault (FormSet, EFI_HII_DEFAULT_CLASS_STANDARD);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Request current settings from Configuration Driver\r
  //\r
  Link = GetFirstNode (&FormSet->StorageListHead);\r
  while (!IsNull (&FormSet->StorageListHead, Link)) {\r
    Storage = FORMSET_STORAGE_FROM_LINK (Link);\r
\r
    OldStorage = NULL;\r
    if (gOldFormSet != NULL) {\r
      //\r
      // Try to find the Storage in backup formset gOldFormSet\r
      //\r
      Link2 = GetFirstNode (&gOldFormSet->StorageListHead);\r
      while (!IsNull (&gOldFormSet->StorageListHead, Link2)) {\r
        StorageSrc = FORMSET_STORAGE_FROM_LINK (Link2);\r
\r
        if (StorageSrc->VarStoreId == Storage->VarStoreId) {\r
          OldStorage = StorageSrc;\r
          break;\r
        }\r
\r
        Link2 = GetNextNode (&gOldFormSet->StorageListHead, Link2);\r
      }\r
    }\r
\r
    if (OldStorage == NULL) {\r
      //\r
      // Storage is not found in backup formset, request it from ConfigDriver\r
      //\r
      Status = LoadStorage (FormSet, Storage);\r
      //\r
      // Now Edit Buffer is filled with default values(lower priority) and current\r
      // settings(higher priority), sychronize it to shadow Buffer\r
      //\r
      if (!EFI_ERROR (Status)) {\r
        SynchronizeStorage (Storage);\r
      }\r
    } else {\r
      //\r
      // Storage found in backup formset, use it\r
      //\r
      Status = CopyStorage (Storage, OldStorage);\r
    }\r
\r
    Link = GetNextNode (&FormSet->StorageListHead, Link);\r
  }\r
\r
  //\r
  // If has old formset, get the old nv update status.\r
  //\r
  if (gOldFormSet != NULL) {\r
      Link = GetFirstNode (&FormSet->FormListHead);\r
      while (!IsNull (&FormSet->FormListHead, Link)) {\r
        Form = FORM_BROWSER_FORM_FROM_LINK (Link);\r
\r
        Link2 = GetFirstNode (&gOldFormSet->FormListHead);\r
        while (!IsNull (&gOldFormSet->FormListHead, Link2)) {\r
          Form2 = FORM_BROWSER_FORM_FROM_LINK (Link2);\r
\r
          if (Form->FormId == Form2->FormId) {\r
            Form->NvUpdateRequired = Form2->NvUpdateRequired;\r
            break;\r
          }\r
\r
          Link2 = GetNextNode (&gOldFormSet->FormListHead, Link2);\r
        }\r
          Link = GetNextNode (&FormSet->FormListHead, Link);\r
      }\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Fetch the Ifr binary data of a FormSet.\r
\r
  @param  Handle                 PackageList Handle\r
  @param  FormSetGuid            On input, GUID or class GUID of a formset. If not\r
                                 specified (NULL or zero GUID), take the first\r
                                 FormSet with class GUID EFI_HII_PLATFORM_SETUP_FORMSET_GUID\r
                                 found in package list.\r
                                 On output, GUID of the formset found(if not NULL).\r
  @param  BinaryLength           The length of the FormSet IFR binary.\r
  @param  BinaryData             The buffer designed to receive the FormSet.\r
\r
  @retval EFI_SUCCESS            Buffer filled with the requested FormSet.\r
                                 BufferLength was updated.\r
  @retval EFI_INVALID_PARAMETER  The handle is unknown.\r
  @retval EFI_NOT_FOUND          A form or FormSet on the requested handle cannot\r
                                 be found with the requested FormId.\r
\r
**/\r
EFI_STATUS\r
GetIfrBinaryData (\r
  IN  EFI_HII_HANDLE   Handle,\r
  IN OUT EFI_GUID      *FormSetGuid,\r
  OUT UINTN            *BinaryLength,\r
  OUT UINT8            **BinaryData\r
  )\r
{\r
  EFI_STATUS                   Status;\r
  EFI_HII_PACKAGE_LIST_HEADER  *HiiPackageList;\r
  UINTN                        BufferSize;\r
  UINT8                        *Package;\r
  UINT8                        *OpCodeData;\r
  UINT32                       Offset;\r
  UINT32                       Offset2;\r
  UINT32                       PackageListLength;\r
  EFI_HII_PACKAGE_HEADER       PackageHeader;\r
  UINT8                        Index;\r
  UINT8                        NumberOfClassGuid;\r
  BOOLEAN                      ClassGuidMatch;\r
  EFI_GUID                     *ClassGuid;\r
  EFI_GUID                     *ComparingGuid;\r
\r
  OpCodeData = NULL;\r
  Package = NULL;\r
  ZeroMem (&PackageHeader, sizeof (EFI_HII_PACKAGE_HEADER));\r
\r
  //\r
  // if FormSetGuid is NULL or zero GUID, return first Setup FormSet in the package list\r
  //\r
  if (FormSetGuid == NULL || CompareGuid (FormSetGuid, &gZeroGuid)) {\r
    ComparingGuid = &gEfiHiiPlatformSetupFormsetGuid;\r
  } else {\r
    ComparingGuid = FormSetGuid;\r
  }\r
\r
  //\r
  // Get HII PackageList\r
  //\r
  BufferSize = 0;\r
  HiiPackageList = NULL;\r
  Status = mHiiDatabase->ExportPackageLists (mHiiDatabase, Handle, &BufferSize, HiiPackageList);\r
  if (Status == EFI_BUFFER_TOO_SMALL) {\r
    HiiPackageList = AllocatePool (BufferSize);\r
    ASSERT (HiiPackageList != NULL);\r
\r
    Status = mHiiDatabase->ExportPackageLists (mHiiDatabase, Handle, &BufferSize, HiiPackageList);\r
  }\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
  ASSERT (HiiPackageList != NULL);\r
\r
  //\r
  // Get Form package from this HII package List\r
  //\r
  Offset = sizeof (EFI_HII_PACKAGE_LIST_HEADER);\r
  Offset2 = 0;\r
  CopyMem (&PackageListLength, &HiiPackageList->PackageLength, sizeof (UINT32));\r
\r
  ClassGuidMatch = FALSE;\r
  while (Offset < PackageListLength) {\r
    Package = ((UINT8 *) HiiPackageList) + Offset;\r
    CopyMem (&PackageHeader, Package, sizeof (EFI_HII_PACKAGE_HEADER));\r
\r
    if (PackageHeader.Type == EFI_HII_PACKAGE_FORMS) {\r
      //\r
      // Search FormSet in this Form Package\r
      //\r
      Offset2 = sizeof (EFI_HII_PACKAGE_HEADER);\r
      while (Offset2 < PackageHeader.Length) {\r
        OpCodeData = Package + Offset2;\r
\r
        if (((EFI_IFR_OP_HEADER *) OpCodeData)->OpCode == EFI_IFR_FORM_SET_OP) {\r
          //\r
          // Try to compare against formset GUID\r
          //\r
          if (CompareGuid (ComparingGuid, (EFI_GUID *)(OpCodeData + sizeof (EFI_IFR_OP_HEADER)))) {\r
            break;\r
          }\r
\r
          if (((EFI_IFR_OP_HEADER *) OpCodeData)->Length > OFFSET_OF (EFI_IFR_FORM_SET, Flags)) {\r
            //\r
            // Try to compare against formset class GUID\r
            //\r
            NumberOfClassGuid = (UINT8) (((EFI_IFR_FORM_SET *) OpCodeData)->Flags & 0x3);\r
            ClassGuid         = (EFI_GUID *) (OpCodeData + sizeof (EFI_IFR_FORM_SET));\r
            for (Index = 0; Index < NumberOfClassGuid; Index++) {\r
              if (CompareGuid (ComparingGuid, ClassGuid + Index)) {\r
                ClassGuidMatch = TRUE;\r
                break;\r
              }\r
            }\r
            if (ClassGuidMatch) {\r
              break;\r
            }\r
          } else if (ComparingGuid == &gEfiHiiPlatformSetupFormsetGuid) {\r
            ClassGuidMatch = TRUE;\r
            break;\r
          }\r
        }\r
\r
        Offset2 += ((EFI_IFR_OP_HEADER *) OpCodeData)->Length;\r
      }\r
\r
      if (Offset2 < PackageHeader.Length) {\r
        //\r
        // Target formset found\r
        //\r
        break;\r
      }\r
    }\r
\r
    Offset += PackageHeader.Length;\r
  }\r
\r
  if (Offset >= PackageListLength) {\r
    //\r
    // Form package not found in this Package List\r
    //\r
    FreePool (HiiPackageList);\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  if (ClassGuidMatch && (FormSetGuid != NULL)) {\r
    //\r
    // Return the FormSet GUID\r
    //\r
    CopyMem (FormSetGuid, &((EFI_IFR_FORM_SET *) OpCodeData)->Guid, sizeof (EFI_GUID));\r
  }\r
\r
  //\r
  // To determine the length of a whole FormSet IFR binary, one have to parse all the Opcodes\r
  // in this FormSet; So, here just simply copy the data from start of a FormSet to the end\r
  // of the Form Package.\r
  //\r
  *BinaryLength = PackageHeader.Length - Offset2;\r
  *BinaryData = AllocateCopyPool (*BinaryLength, OpCodeData);\r
\r
  FreePool (HiiPackageList);\r
\r
  if (*BinaryData == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Initialize the internal data structure of a FormSet.\r
\r
  @param  Handle                 PackageList Handle\r
  @param  FormSetGuid            On input, GUID or class GUID of a formset. If not\r
                                 specified (NULL or zero GUID), take the first\r
                                 FormSet with class GUID EFI_HII_PLATFORM_SETUP_FORMSET_GUID\r
                                 found in package list.\r
                                 On output, GUID of the formset found(if not NULL).\r
  @param  FormSet                FormSet data structure.\r
\r
  @retval EFI_SUCCESS            The function completed successfully.\r
  @retval EFI_NOT_FOUND          The specified FormSet could not be found.\r
\r
**/\r
EFI_STATUS\r
InitializeFormSet (\r
  IN  EFI_HII_HANDLE                   Handle,\r
  IN OUT EFI_GUID                      *FormSetGuid,\r
  OUT FORM_BROWSER_FORMSET             *FormSet\r
  )\r
{\r
  EFI_STATUS                Status;\r
  EFI_HANDLE                DriverHandle;\r
  UINT16                    Index;\r
\r
  Status = GetIfrBinaryData (Handle, FormSetGuid, &FormSet->IfrBinaryLength, &FormSet->IfrBinaryData);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  FormSet->HiiHandle = Handle;\r
  CopyMem (&FormSet->Guid, FormSetGuid, sizeof (EFI_GUID));\r
\r
  //\r
  // Retrieve ConfigAccess Protocol associated with this HiiPackageList\r
  //\r
  Status = mHiiDatabase->GetPackageListHandle (mHiiDatabase, Handle, &DriverHandle);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
  FormSet->DriverHandle = DriverHandle;\r
  Status = gBS->HandleProtocol (\r
                  DriverHandle,\r
                  &gEfiHiiConfigAccessProtocolGuid,\r
                  (VOID **) &FormSet->ConfigAccess\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    //\r
    // Configuration Driver don't attach ConfigAccess protocol to its HII package\r
    // list, then there will be no configuration action required\r
    //\r
    FormSet->ConfigAccess = NULL;\r
  }\r
\r
  //\r
  // Parse the IFR binary OpCodes\r
  //\r
  Status = ParseOpCodes (FormSet);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Set VFR type by FormSet SubClass field\r
  //\r
  gClassOfVfr = FORMSET_CLASS_PLATFORM_SETUP;\r
  if (FormSet->SubClass == EFI_FRONT_PAGE_SUBCLASS) {\r
    gClassOfVfr = FORMSET_CLASS_FRONT_PAGE;\r
  }\r
  \r
  //\r
  // Set VFR type by FormSet class guid\r
  //\r
  for (Index = 0; Index < 3; Index ++) {\r
    if (CompareGuid (&FormSet->ClassGuid[Index], &gEfiHiiPlatformSetupFormsetGuid)) {\r
      gClassOfVfr |= FORMSET_CLASS_PLATFORM_SETUP;\r
      break;\r
    }\r
  }\r
\r
  if ((gClassOfVfr & FORMSET_CLASS_FRONT_PAGE) == FORMSET_CLASS_FRONT_PAGE) {\r
    gFrontPageHandle = FormSet->HiiHandle;\r
  }\r
\r
  //\r
  // Match GUID to find out the function key setting. If match fail, use the default setting.\r
  //\r
  for (Index = 0; Index < sizeof (gFunctionKeySettingTable) / sizeof (FUNCTIION_KEY_SETTING); Index++) {\r
    if (CompareGuid (&FormSet->Guid, &(gFunctionKeySettingTable[Index].FormSetGuid))) {\r
      //\r
      // Update the function key setting.\r
      //\r
      gFunctionKeySetting = gFunctionKeySettingTable[Index].KeySetting;\r
      //\r
      // Function key prompt can not be displayed if the function key has been disabled.\r
      //\r
      if ((gFunctionKeySetting & FUNCTION_NINE) != FUNCTION_NINE) {\r
        gFunctionNineString = GetToken (STRING_TOKEN (EMPTY_STRING), gHiiHandle);\r
      }\r
\r
      if ((gFunctionKeySetting & FUNCTION_TEN) != FUNCTION_TEN) {\r
        gFunctionTenString = GetToken (STRING_TOKEN (EMPTY_STRING), gHiiHandle);\r
      }\r
    }\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Save globals used by previous call to SendForm(). SendForm() may be called from \r
  HiiConfigAccess.Callback(), this will cause SendForm() be reentried.\r
  So, save globals of previous call to SendForm() and restore them upon exit.\r
\r
**/\r
VOID\r
SaveBrowserContext (\r
  VOID\r
  )\r
{\r
  BROWSER_CONTEXT  *Context;\r
\r
  gBrowserContextCount++;\r
  if (gBrowserContextCount == 1) {\r
    //\r
    // This is not reentry of SendForm(), no context to save\r
    //\r
    return;\r
  }\r
\r
  Context = AllocatePool (sizeof (BROWSER_CONTEXT));\r
  ASSERT (Context != NULL);\r
\r
  Context->Signature = BROWSER_CONTEXT_SIGNATURE;\r
\r
  //\r
  // Save FormBrowser context\r
  //\r
  Context->BannerData           = gBannerData;\r
  Context->ClassOfVfr           = gClassOfVfr;\r
  Context->FunctionKeySetting   = gFunctionKeySetting;\r
  Context->ResetRequired        = gResetRequired;\r
  Context->Direction            = gDirection;\r
  Context->FunctionNineString   = gFunctionNineString;\r
  Context->FunctionTenString    = gFunctionTenString;\r
  Context->EnterString          = gEnterString;\r
  Context->EnterCommitString    = gEnterCommitString;\r
  Context->EnterEscapeString    = gEnterEscapeString;\r
  Context->EscapeString         = gEscapeString;\r
  Context->SaveFailed           = gSaveFailed;\r
  Context->MoveHighlight        = gMoveHighlight;\r
  Context->MakeSelection        = gMakeSelection;\r
  Context->DecNumericInput      = gDecNumericInput;\r
  Context->HexNumericInput      = gHexNumericInput;\r
  Context->ToggleCheckBox       = gToggleCheckBox;\r
  Context->PromptForData        = gPromptForData;\r
  Context->PromptForPassword    = gPromptForPassword;\r
  Context->PromptForNewPassword = gPromptForNewPassword;\r
  Context->ConfirmPassword      = gConfirmPassword;\r
  Context->ConfirmError         = gConfirmError;\r
  Context->PassowordInvalid     = gPassowordInvalid;\r
  Context->PressEnter           = gPressEnter;\r
  Context->EmptyString          = gEmptyString;\r
  Context->AreYouSure           = gAreYouSure;\r
  Context->YesResponse          = gYesResponse;\r
  Context->NoResponse           = gNoResponse;\r
  Context->MiniString           = gMiniString;\r
  Context->PlusString           = gPlusString;\r
  Context->MinusString          = gMinusString;\r
  Context->AdjustNumber         = gAdjustNumber;\r
  Context->SaveChanges          = gSaveChanges;\r
  Context->OptionMismatch       = gOptionMismatch;\r
  Context->FormSuppress         = gFormSuppress;\r
  Context->PromptBlockWidth     = gPromptBlockWidth;\r
  Context->OptionBlockWidth     = gOptionBlockWidth;\r
  Context->HelpBlockWidth       = gHelpBlockWidth;\r
  Context->OldFormSet           = gOldFormSet;\r
  Context->MenuRefreshHead      = gMenuRefreshHead;\r
\r
  CopyMem (&Context->ScreenDimensions, &gScreenDimensions, sizeof (gScreenDimensions));\r
  CopyMem (&Context->MenuOption, &gMenuOption, sizeof (gMenuOption));\r
\r
  //\r
  // Insert to FormBrowser context list\r
  //\r
  InsertHeadList (&gBrowserContextList, &Context->Link);\r
}\r
\r
\r
/**\r
  Restore globals used by previous call to SendForm().\r
\r
**/\r
VOID\r
RestoreBrowserContext (\r
  VOID\r
  )\r
{\r
  LIST_ENTRY       *Link;\r
  BROWSER_CONTEXT  *Context;\r
\r
  ASSERT (gBrowserContextCount != 0);\r
  gBrowserContextCount--;\r
  if (gBrowserContextCount == 0) {\r
    //\r
    // This is not reentry of SendForm(), no context to restore\r
    //\r
    return;\r
  }\r
\r
  ASSERT (!IsListEmpty (&gBrowserContextList));\r
\r
  Link = GetFirstNode (&gBrowserContextList);\r
  Context = BROWSER_CONTEXT_FROM_LINK (Link);\r
\r
  //\r
  // Restore FormBrowser context\r
  //\r
  gBannerData           = Context->BannerData;\r
  gClassOfVfr           = Context->ClassOfVfr;\r
  gFunctionKeySetting   = Context->FunctionKeySetting;\r
  gResetRequired        = Context->ResetRequired;\r
  gDirection            = Context->Direction;\r
  gFunctionNineString   = Context->FunctionNineString;\r
  gFunctionTenString    = Context->FunctionTenString;\r
  gEnterString          = Context->EnterString;\r
  gEnterCommitString    = Context->EnterCommitString;\r
  gEnterEscapeString    = Context->EnterEscapeString;\r
  gEscapeString         = Context->EscapeString;\r
  gSaveFailed           = Context->SaveFailed;\r
  gMoveHighlight        = Context->MoveHighlight;\r
  gMakeSelection        = Context->MakeSelection;\r
  gDecNumericInput      = Context->DecNumericInput;\r
  gHexNumericInput      = Context->HexNumericInput;\r
  gToggleCheckBox       = Context->ToggleCheckBox;\r
  gPromptForData        = Context->PromptForData;\r
  gPromptForPassword    = Context->PromptForPassword;\r
  gPromptForNewPassword = Context->PromptForNewPassword;\r
  gConfirmPassword      = Context->ConfirmPassword;\r
  gConfirmError         = Context->ConfirmError;\r
  gPassowordInvalid     = Context->PassowordInvalid;\r
  gPressEnter           = Context->PressEnter;\r
  gEmptyString          = Context->EmptyString;\r
  gAreYouSure           = Context->AreYouSure;\r
  gYesResponse          = Context->YesResponse;\r
  gNoResponse           = Context->NoResponse;\r
  gMiniString           = Context->MiniString;\r
  gPlusString           = Context->PlusString;\r
  gMinusString          = Context->MinusString;\r
  gAdjustNumber         = Context->AdjustNumber;\r
  gSaveChanges          = Context->SaveChanges;\r
  gOptionMismatch       = Context->OptionMismatch;\r
  gFormSuppress         = Context->FormSuppress;\r
  gPromptBlockWidth     = Context->PromptBlockWidth;\r
  gOptionBlockWidth     = Context->OptionBlockWidth;\r
  gHelpBlockWidth       = Context->HelpBlockWidth;\r
  gOldFormSet           = Context->OldFormSet;\r
  gMenuRefreshHead      = Context->MenuRefreshHead;\r
\r
  CopyMem (&gScreenDimensions, &Context->ScreenDimensions, sizeof (gScreenDimensions));\r
  CopyMem (&gMenuOption, &Context->MenuOption, sizeof (gMenuOption));\r
\r
  //\r
  // Remove from FormBrowser context list\r
  //\r
  RemoveEntryList (&Context->Link);\r
  gBS->FreePool (Context);\r
}\r