[mirror_edk2.git] / IntelFrameworkModulePkg / Universal / BdsDxe / DeviceMngr / DeviceManager.c

/** @file\r
  The platform device manager reference implementation\r
\r
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "DeviceManager.h"\r
\r
DEVICE_MANAGER_CALLBACK_DATA  gDeviceManagerPrivate = {\r
  DEVICE_MANAGER_CALLBACK_DATA_SIGNATURE,\r
  NULL,\r
  NULL,\r
  NULL,\r
  NULL,\r
  {\r
    FakeExtractConfig,\r
    FakeRouteConfig,\r
    DeviceManagerCallback\r
  },\r
  {\r
    FakeExtractConfig,\r
    FakeRouteConfig,\r
    DriverHealthCallback\r
  }\r
};\r
\r
#define  MAX_MAC_ADDRESS_NODE_LIST_LEN    10\r
\r
//\r
// Which Mac Address string is select\r
// it will decide what menu need to show in the NETWORK_DEVICE_FORM_ID form.\r
//\r
EFI_STRING  mSelectedMacAddrString;\r
\r
//\r
// Which form Id need to be show.\r
//\r
EFI_FORM_ID      mNextShowFormId = DEVICE_MANAGER_FORM_ID;\r
\r
//\r
// The Mac Address show in the NETWORK_DEVICE_LIST_FORM_ID\r
//\r
MAC_ADDRESS_NODE_LIST  mMacDeviceList;\r
\r
DEVICE_MANAGER_MENU_ITEM  mDeviceManagerMenuItemTable[] = {\r
  { STRING_TOKEN (STR_DISK_DEVICE),     EFI_DISK_DEVICE_CLASS },\r
  { STRING_TOKEN (STR_VIDEO_DEVICE),    EFI_VIDEO_DEVICE_CLASS },\r
  { STRING_TOKEN (STR_NETWORK_DEVICE),  EFI_NETWORK_DEVICE_CLASS },\r
  { STRING_TOKEN (STR_INPUT_DEVICE),    EFI_INPUT_DEVICE_CLASS },\r
  { STRING_TOKEN (STR_ON_BOARD_DEVICE), EFI_ON_BOARD_DEVICE_CLASS },\r
  { STRING_TOKEN (STR_OTHER_DEVICE),    EFI_OTHER_DEVICE_CLASS }\r
};\r
\r
HII_VENDOR_DEVICE_PATH  mDeviceManagerHiiVendorDevicePath = {\r
  {\r
    {\r
      HARDWARE_DEVICE_PATH,\r
      HW_VENDOR_DP,\r
      {\r
        (UINT8) (sizeof (VENDOR_DEVICE_PATH)),\r
        (UINT8) ((sizeof (VENDOR_DEVICE_PATH)) >> 8)\r
      }\r
    },\r
    DEVICE_MANAGER_FORMSET_GUID\r
  },\r
  {\r
    END_DEVICE_PATH_TYPE,\r
    END_ENTIRE_DEVICE_PATH_SUBTYPE,\r
    {\r
      (UINT8) (END_DEVICE_PATH_LENGTH),\r
      (UINT8) ((END_DEVICE_PATH_LENGTH) >> 8)\r
    }\r
  }\r
};\r
\r
HII_VENDOR_DEVICE_PATH  mDriverHealthHiiVendorDevicePath = {\r
  {\r
    {\r
      HARDWARE_DEVICE_PATH,\r
        HW_VENDOR_DP,\r
      {\r
        (UINT8) (sizeof (VENDOR_DEVICE_PATH)),\r
          (UINT8) ((sizeof (VENDOR_DEVICE_PATH)) >> 8)\r
      }\r
    },\r
    DRIVER_HEALTH_FORMSET_GUID\r
  },\r
  {\r
    END_DEVICE_PATH_TYPE,\r
      END_ENTIRE_DEVICE_PATH_SUBTYPE,\r
    {\r
      (UINT8) (END_DEVICE_PATH_LENGTH),\r
        (UINT8) ((END_DEVICE_PATH_LENGTH) >> 8)\r
    }\r
  }\r
};\r
\r
/**\r
  This function is invoked if user selected a interactive opcode from Device Manager's\r
  Formset. The decision by user is saved to gCallbackKey for later processing. If\r
  user set VBIOS, the new value is saved to EFI variable.\r
\r
  @param This            Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param Action          Specifies the type of action taken by the browser.\r
  @param QuestionId      A unique value which is sent to the original exporting driver\r
                         so that it can identify the type of data to expect.\r
  @param Type            The type of value for the question.\r
  @param Value           A pointer to the data being sent to the original exporting driver.\r
  @param ActionRequest   On return, points to the action requested by the callback function.\r
\r
  @retval  EFI_SUCCESS           The callback successfully handled the action.\r
  @retval  EFI_INVALID_PARAMETER The setup browser call this function with invalid parameters.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DeviceManagerCallback (\r
  IN  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL   *This,\r
  IN  EFI_BROWSER_ACTION                     Action,\r
  IN  EFI_QUESTION_ID                        QuestionId,\r
  IN  UINT8                                  Type,\r
  IN  EFI_IFR_TYPE_VALUE                     *Value,\r
  OUT EFI_BROWSER_ACTION_REQUEST             *ActionRequest\r
  )\r
{\r
  UINTN CurIndex;\r
\r
  if (Action != EFI_BROWSER_ACTION_CHANGING) {\r
    //\r
    // All other action return unsupported.\r
    //\r
    return EFI_UNSUPPORTED;\r
  }\r
\r
  if (Value == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  gCallbackKey = QuestionId;\r
  if ((QuestionId < MAX_KEY_SECTION_LEN + NETWORK_DEVICE_LIST_KEY_OFFSET) && (QuestionId >= NETWORK_DEVICE_LIST_KEY_OFFSET)) {\r
    //\r
    // If user select the mac address, need to record mac address string to support next form show.\r
    //\r
    for (CurIndex = 0; CurIndex < mMacDeviceList.CurListLen; CurIndex ++) {\r
      if (mMacDeviceList.NodeList[CurIndex].QuestionId == QuestionId) {\r
         mSelectedMacAddrString = HiiGetString (gDeviceManagerPrivate.HiiHandle, mMacDeviceList.NodeList[CurIndex].PromptId, NULL);\r
      }\r
    }\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  This function registers HII packages to HII database.\r
\r
  @retval  EFI_SUCCESS           HII packages for the Device Manager were registered successfully.\r
  @retval  EFI_OUT_OF_RESOURCES  HII packages for the Device Manager failed to be registered.\r
\r
**/\r
EFI_STATUS\r
InitializeDeviceManager (\r
  VOID\r
  )\r
{\r
  EFI_STATUS                  Status;\r
\r
  //\r
  // Install Device Path Protocol and Config Access protocol to driver handle\r
  //\r
  Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &gDeviceManagerPrivate.DriverHandle,\r
                  &gEfiDevicePathProtocolGuid,\r
                  &mDeviceManagerHiiVendorDevicePath,\r
                  &gEfiHiiConfigAccessProtocolGuid,\r
                  &gDeviceManagerPrivate.ConfigAccess,\r
                  NULL\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &gDeviceManagerPrivate.DriverHealthHandle,\r
                  &gEfiDevicePathProtocolGuid,\r
                  &mDriverHealthHiiVendorDevicePath,\r
                  &gEfiHiiConfigAccessProtocolGuid,\r
                  &gDeviceManagerPrivate.DriverHealthConfigAccess,\r
                  NULL\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  mMacDeviceList.CurListLen = 0;\r
  mMacDeviceList.MaxListLen = 0;\r
\r
  return Status;\r
}\r
\r
/**\r
  Extract the displayed formset for given HII handle and class guid.\r
\r
  @param Handle          The HII handle.\r
  @param SetupClassGuid  The class guid specifies which form set will be displayed.\r
  @param SkipCount       Skip some formsets which has processed before.\r
  @param FormSetTitle    Formset title string.\r
  @param FormSetHelp     Formset help string.\r
  @param FormSetGuid     Return the formset guid for this formset.\r
\r
  @retval  TRUE          The formset for given HII handle will be displayed.\r
  @return  FALSE         The formset for given HII handle will not be displayed.\r
\r
**/\r
BOOLEAN\r
ExtractDisplayedHiiFormFromHiiHandle (\r
  IN      EFI_HII_HANDLE      Handle,\r
  IN      EFI_GUID            *SetupClassGuid,\r
  IN      UINTN               SkipCount,\r
  OUT     EFI_STRING_ID       *FormSetTitle,\r
  OUT     EFI_STRING_ID       *FormSetHelp,\r
  OUT     EFI_GUID            **FormSetGuid\r
  )\r
{\r
  EFI_STATUS                   Status;\r
  UINTN                        BufferSize;\r
  EFI_HII_PACKAGE_LIST_HEADER  *HiiPackageList;\r
  UINT8                        *Package;\r
  UINT8                        *OpCodeData;\r
  UINT32                       Offset;\r
  UINT32                       Offset2;\r
  UINT32                       PackageListLength;\r
  EFI_HII_PACKAGE_HEADER       PackageHeader;\r
  EFI_GUID                     *ClassGuid;\r
  UINT8                        ClassGuidNum;\r
\r
  ASSERT (Handle != NULL);\r
  ASSERT (SetupClassGuid != NULL);\r
  ASSERT (FormSetTitle != NULL);\r
  ASSERT (FormSetHelp != NULL);\r
\r
  *FormSetTitle = 0;\r
  *FormSetHelp  = 0;\r
  ClassGuidNum  = 0;\r
  ClassGuid     = NULL;\r
\r
  //\r
  // Get HII PackageList\r
  //\r
  BufferSize = 0;\r
  HiiPackageList = NULL;\r
  Status = gHiiDatabase->ExportPackageLists (gHiiDatabase, Handle, &BufferSize, HiiPackageList);\r
  //\r
  // Handle is a invalid handle. Check if Handle is corrupted.\r
  //\r
  ASSERT (Status != EFI_NOT_FOUND);\r
  //\r
  // The return status should always be EFI_BUFFER_TOO_SMALL as input buffer's size is 0.\r
  //\r
  ASSERT (Status == EFI_BUFFER_TOO_SMALL);\r
\r
  HiiPackageList = AllocatePool (BufferSize);\r
  ASSERT (HiiPackageList != NULL);\r
\r
  Status = gHiiDatabase->ExportPackageLists (gHiiDatabase, Handle, &BufferSize, HiiPackageList);\r
  if (EFI_ERROR (Status)) {\r
    return FALSE;\r
  }\r
\r
  //\r
  // Get Form package from this HII package List\r
  //\r
  Offset = sizeof (EFI_HII_PACKAGE_LIST_HEADER);\r
  Offset2 = 0;\r
  PackageListLength = ReadUnaligned32 (&HiiPackageList->PackageLength);\r
\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 Opcode in this Form Package\r
      //\r
      Offset2 = sizeof (EFI_HII_PACKAGE_HEADER);\r
      while (Offset2 < PackageHeader.Length) {\r
        OpCodeData = Package + Offset2;\r
        Offset2 += ((EFI_IFR_OP_HEADER *) OpCodeData)->Length;\r
\r
        if (((EFI_IFR_OP_HEADER *) OpCodeData)->OpCode == EFI_IFR_FORM_SET_OP) {\r
          if (SkipCount != 0) {\r
            SkipCount --;\r
            continue;\r
          }\r
\r
          if (((EFI_IFR_OP_HEADER *) OpCodeData)->Length > OFFSET_OF (EFI_IFR_FORM_SET, Flags)) {\r
            //\r
            // Find FormSet OpCode\r
            //\r
            ClassGuidNum = (UINT8) (((EFI_IFR_FORM_SET *) OpCodeData)->Flags & 0x3);\r
            ClassGuid = (EFI_GUID *) (VOID *)(OpCodeData + sizeof (EFI_IFR_FORM_SET));\r
            while (ClassGuidNum-- > 0) {\r
              if (CompareGuid (SetupClassGuid, ClassGuid)) {\r
                CopyMem (FormSetTitle, &((EFI_IFR_FORM_SET *) OpCodeData)->FormSetTitle, sizeof (EFI_STRING_ID));\r
                CopyMem (FormSetHelp, &((EFI_IFR_FORM_SET *) OpCodeData)->Help, sizeof (EFI_STRING_ID));\r
                *FormSetGuid = AllocateCopyPool (sizeof (EFI_GUID), &((EFI_IFR_FORM_SET *) OpCodeData)->Guid);\r
                ASSERT (*FormSetGuid != NULL);\r
                FreePool (HiiPackageList);\r
                return TRUE;\r
              }\r
              ClassGuid ++;\r
            }\r
           } else {\r
             CopyMem (FormSetTitle, &((EFI_IFR_FORM_SET *) OpCodeData)->FormSetTitle, sizeof (EFI_STRING_ID));\r
             CopyMem (FormSetHelp, &((EFI_IFR_FORM_SET *) OpCodeData)->Help, sizeof (EFI_STRING_ID));\r
             *FormSetGuid = AllocateCopyPool (sizeof (EFI_GUID), &((EFI_IFR_FORM_SET *) OpCodeData)->Guid);\r
             ASSERT (*FormSetGuid != NULL);\r
             FreePool (HiiPackageList);\r
             return TRUE;\r
          }\r
        }\r
      }\r
    }\r
\r
    //\r
    // Go to next package\r
    //\r
    Offset += PackageHeader.Length;\r
  }\r
\r
  FreePool (HiiPackageList);\r
\r
  return FALSE;\r
}\r
\r
/**\r
  Get the mac address string from the device path.\r
  if the device path has the vlan, get the vanid also.\r
\r
  @param MacAddressNode              Device path begin with mac address\r
  @param PBuffer                     Output string buffer contain mac address.\r
\r
**/\r
BOOLEAN\r
GetMacAddressString(\r
  IN  MAC_ADDR_DEVICE_PATH   *MacAddressNode,\r
  OUT CHAR16                 **PBuffer\r
  )\r
{\r
  UINTN                 HwAddressSize;\r
  UINTN                 Index;\r
  UINT8                 *HwAddress;\r
  EFI_DEVICE_PATH_PROTOCOL  *Node;\r
  UINT16                VlanId;\r
  CHAR16                *String;\r
  UINTN                 BufferLen;\r
\r
  VlanId = 0;\r
  String = NULL;\r
  ASSERT(MacAddressNode != NULL);\r
\r
  HwAddressSize = sizeof (EFI_MAC_ADDRESS);\r
  if (MacAddressNode->IfType == 0x01 || MacAddressNode->IfType == 0x00) {\r
    HwAddressSize = 6;\r
  }\r
\r
  //\r
  // The output format is MAC:XX:XX:XX:...\XXXX\r
  // The size is the Number size + ":" size + Vlan size(\XXXX) + End\r
  //\r
  BufferLen = (4 + 2 * HwAddressSize + (HwAddressSize - 1) + 5 + 1) * sizeof (CHAR16);\r
  String = AllocateZeroPool (BufferLen);\r
  if (String == NULL) {\r
    return FALSE;\r
  }\r
\r
  *PBuffer = String;\r
  StrCpyS (String, BufferLen / sizeof (CHAR16), L"MAC:");\r
  String += 4;\r
\r
  //\r
  // Convert the MAC address into a unicode string.\r
  //\r
  HwAddress = &MacAddressNode->MacAddress.Addr[0];\r
  for (Index = 0; Index < HwAddressSize; Index++) {\r
    UnicodeValueToStringS (\r
      String,\r
      BufferLen - ((UINTN)String - (UINTN)*PBuffer),\r
      PREFIX_ZERO | RADIX_HEX,\r
      *(HwAddress++),\r
      2\r
      );\r
    String += StrnLenS (String, (BufferLen - ((UINTN)String - (UINTN)*PBuffer)) / sizeof (CHAR16));\r
    if (Index < HwAddressSize - 1) {\r
      *String++ = L':';\r
    }\r
  }\r
\r
  //\r
  // If VLAN is configured, it will need extra 5 characters like "\0005".\r
  // Plus one unicode character for the null-terminator.\r
  //\r
  Node = (EFI_DEVICE_PATH_PROTOCOL  *)MacAddressNode;\r
  while (!IsDevicePathEnd (Node)) {\r
    if (Node->Type == MESSAGING_DEVICE_PATH && Node->SubType == MSG_VLAN_DP) {\r
      VlanId = ((VLAN_DEVICE_PATH *) Node)->VlanId;\r
    }\r
    Node = NextDevicePathNode (Node);\r
  }\r
\r
  if (VlanId != 0) {\r
    *String++ = L'\\';\r
    UnicodeValueToStringS (\r
      String,\r
      BufferLen - ((UINTN)String - (UINTN)*PBuffer),\r
      PREFIX_ZERO | RADIX_HEX,\r
      VlanId,\r
      4\r
      );\r
    String += StrnLenS (String, (BufferLen - ((UINTN)String - (UINTN)*PBuffer)) / sizeof (CHAR16));\r
  }\r
\r
  //\r
  // Null terminate the Unicode string\r
  //\r
  *String = L'\0';\r
\r
  return TRUE;\r
}\r
\r
/**\r
  Save question id and prompt id to the mac device list.\r
  If the same mac address has saved yet, no need to add more.\r
\r
  @param MacAddrString               Mac address string.\r
\r
  @retval  EFI_SUCCESS               Add the item is successful.\r
  @return  Other values if failed to Add the item.\r
**/\r
BOOLEAN\r
AddIdToMacDeviceList (\r
  IN  EFI_STRING        MacAddrString\r
  )\r
{\r
  MENU_INFO_ITEM *TempDeviceList;\r
  UINTN          Index;\r
  EFI_STRING     StoredString;\r
  EFI_STRING_ID  PromptId;\r
  EFI_HII_HANDLE HiiHandle;\r
\r
  HiiHandle =   gDeviceManagerPrivate.HiiHandle;\r
  TempDeviceList = NULL;\r
\r
  for (Index = 0; Index < mMacDeviceList.CurListLen; Index ++) {\r
    StoredString = HiiGetString (HiiHandle, mMacDeviceList.NodeList[Index].PromptId, NULL);\r
    if (StoredString == NULL) {\r
      return FALSE;\r
    }\r
\r
    //\r
    // Already has save the same mac address to the list.\r
    //\r
    if (StrCmp (MacAddrString, StoredString) == 0) {\r
      return FALSE;\r
    }\r
  }\r
\r
  PromptId = HiiSetString(HiiHandle, 0, MacAddrString, NULL);\r
  //\r
  // If not in the list, save it.\r
  //\r
  if (mMacDeviceList.MaxListLen > mMacDeviceList.CurListLen + 1) {\r
    mMacDeviceList.NodeList[mMacDeviceList.CurListLen].PromptId = PromptId;\r
    mMacDeviceList.NodeList[mMacDeviceList.CurListLen].QuestionId = (EFI_QUESTION_ID) (mMacDeviceList.CurListLen + NETWORK_DEVICE_LIST_KEY_OFFSET);\r
  } else {\r
    mMacDeviceList.MaxListLen += MAX_MAC_ADDRESS_NODE_LIST_LEN;\r
    if (mMacDeviceList.CurListLen != 0) {\r
      TempDeviceList = ReallocatePool (\r
                         sizeof (MENU_INFO_ITEM) * mMacDeviceList.CurListLen,\r
                         sizeof (MENU_INFO_ITEM) * mMacDeviceList.MaxListLen,\r
                         mMacDeviceList.NodeList\r
                         );\r
    } else {\r
      TempDeviceList = (MENU_INFO_ITEM *)AllocatePool (sizeof (MENU_INFO_ITEM) * mMacDeviceList.MaxListLen);\r
    }\r
\r
    if (TempDeviceList == NULL) {\r
      return FALSE;\r
    }\r
    TempDeviceList[mMacDeviceList.CurListLen].PromptId = PromptId;\r
    TempDeviceList[mMacDeviceList.CurListLen].QuestionId = (EFI_QUESTION_ID) (mMacDeviceList.CurListLen + NETWORK_DEVICE_LIST_KEY_OFFSET);\r
\r
    mMacDeviceList.NodeList = TempDeviceList;\r
  }\r
  mMacDeviceList.CurListLen ++;\r
\r
  return TRUE;\r
}\r
\r
/**\r
  Check the devcie path, try to find whether it has mac address path.\r
\r
  In this function, first need to check whether this path has mac address path.\r
  second, when the mac address device path has find, also need to deicide whether\r
  need to add this mac address relate info to the menu.\r
\r
  @param    *Node           Input device which need to be check.\r
  @param    *NeedAddItem    Whether need to add the menu in the network device list.\r
\r
  @retval  TRUE             Has mac address device path.\r
  @retval  FALSE            NOT Has mac address device path.\r
\r
**/\r
BOOLEAN\r
IsMacAddressDevicePath (\r
  IN  VOID    *Node,\r
  OUT BOOLEAN *NeedAddItem\r
  )\r
{\r
  EFI_DEVICE_PATH_PROTOCOL   *DevicePath;\r
  CHAR16                     *Buffer;\r
  BOOLEAN                    ReturnVal;\r
\r
  ASSERT (Node != NULL);\r
  *NeedAddItem = FALSE;\r
  ReturnVal    = FALSE;\r
  Buffer    = NULL;\r
\r
  DevicePath = (EFI_DEVICE_PATH_PROTOCOL *) Node;\r
\r
  //\r
  // find the partition device path node\r
  //\r
  while (!IsDevicePathEnd (DevicePath)) {\r
    if ((DevicePathType (DevicePath) == MESSAGING_DEVICE_PATH) &&\r
       (DevicePathSubType (DevicePath) == MSG_MAC_ADDR_DP)) {\r
      ReturnVal = TRUE;\r
\r
      if (DEVICE_MANAGER_FORM_ID == mNextShowFormId) {\r
        *NeedAddItem = TRUE;\r
        break;\r
      }\r
\r
      if (!GetMacAddressString((MAC_ADDR_DEVICE_PATH*)DevicePath, &Buffer)) {\r
        break;\r
      }\r
\r
      if (NETWORK_DEVICE_FORM_ID == mNextShowFormId) {\r
        if (StrCmp (Buffer, mSelectedMacAddrString) == 0) {\r
          *NeedAddItem = TRUE;\r
        }\r
        break;\r
      }\r
\r
      if (NETWORK_DEVICE_LIST_FORM_ID == mNextShowFormId) {\r
        //\r
        // Same handle may has two network child handle, so the questionid\r
        // has the offset of SAME_HANDLE_KEY_OFFSET.\r
        //\r
        if (AddIdToMacDeviceList (Buffer)) {\r
          *NeedAddItem = TRUE;\r
        }\r
        break;\r
      }\r
    }\r
    DevicePath = NextDevicePathNode (DevicePath);\r
  }\r
\r
  if (Buffer != NULL) {\r
    FreePool (Buffer);\r
  }\r
\r
  return ReturnVal;\r
}\r
\r
/**\r
  Check to see if the device path is for the network device.\r
\r
  @param Handle          The HII handle which include the mac address device path.\r
  @param ItemCount       The new add Mac address item count.\r
\r
  @retval  TRUE          Need to add new item in the menu.\r
  @return  FALSE         Do not need to add the menu about the network.\r
\r
**/\r
BOOLEAN\r
IsNeedAddNetworkMenu (\r
  IN      EFI_HII_HANDLE      Handle,\r
  OUT     UINTN               *ItemCount\r
  )\r
{\r
  EFI_STATUS     Status;\r
  UINTN          EntryCount;\r
  UINTN          Index;\r
  EFI_HANDLE     DriverHandle;\r
  EFI_HANDLE     ControllerHandle;\r
  EFI_DEVICE_PATH_PROTOCOL   *DevicePath;\r
  EFI_DEVICE_PATH_PROTOCOL   *TmpDevicePath;\r
  EFI_DEVICE_PATH_PROTOCOL   *ChildDevicePath;\r
  EFI_OPEN_PROTOCOL_INFORMATION_ENTRY   *OpenInfoBuffer;\r
  BOOLEAN        IsNeedAdd;\r
\r
  IsNeedAdd  = FALSE;\r
  OpenInfoBuffer = NULL;\r
  if ((Handle == NULL) || (ItemCount == NULL)) {\r
    return FALSE;\r
  }\r
  *ItemCount = 0;\r
\r
  Status = gHiiDatabase->GetPackageListHandle (gHiiDatabase, Handle, &DriverHandle);\r
  if (EFI_ERROR (Status)) {\r
    return FALSE;\r
  }\r
  //\r
  // Get the device path by the got Driver handle .\r
  //\r
  Status = gBS->HandleProtocol (DriverHandle, &gEfiDevicePathProtocolGuid, (VOID **) &DevicePath);\r
  if (EFI_ERROR (Status)) {\r
    return FALSE;\r
  }\r
  TmpDevicePath = DevicePath;\r
\r
  //\r
  // Check whether this device path include mac address device path.\r
  // If this path has mac address path, get the value whether need\r
  // add this info to the menu and return.\r
  // Else check more about the child handle devcie path.\r
  //\r
  if (IsMacAddressDevicePath(TmpDevicePath, &IsNeedAdd)) {\r
    if ((NETWORK_DEVICE_LIST_FORM_ID == mNextShowFormId) && IsNeedAdd) {\r
      (*ItemCount) = 1;\r
    }\r
    return IsNeedAdd;\r
  }\r
\r
  //\r
  // Search whether this path is the controller path, not he child handle path.\r
  // And the child handle has the network devcie connected.\r
  //\r
  TmpDevicePath = DevicePath;\r
  Status = gBS->LocateDevicePath(&gEfiDevicePathProtocolGuid, &TmpDevicePath, &ControllerHandle);\r
  if (EFI_ERROR (Status)) {\r
    return FALSE;\r
  }\r
\r
  if (!IsDevicePathEnd (TmpDevicePath)) {\r
    return FALSE;\r
  }\r
\r
  //\r
  // Retrieve the list of agents that are consuming the specific protocol\r
  // on ControllerHandle.\r
  // The buffer point by OpenInfoBuffer need be free at this function.\r
  //\r
  Status = gBS->OpenProtocolInformation (\r
                  ControllerHandle,\r
                  &gEfiPciIoProtocolGuid,\r
                  &OpenInfoBuffer,\r
                  &EntryCount\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    return FALSE;\r
  }\r
\r
  //\r
  // Inspect if ChildHandle is one of the agents.\r
  //\r
  Status = EFI_UNSUPPORTED;\r
  for (Index = 0; Index < EntryCount; Index++) {\r
    //\r
    // Query all the children created by the controller handle's driver\r
    //\r
    if ((OpenInfoBuffer[Index].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
      Status = gBS->OpenProtocol (\r
                      OpenInfoBuffer[Index].ControllerHandle,\r
                      &gEfiDevicePathProtocolGuid,\r
                      (VOID **) &ChildDevicePath,\r
                      NULL,\r
                      NULL,\r
                      EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
                      );\r
      if (EFI_ERROR (Status)) {\r
        continue;\r
      }\r
\r
      //\r
      // Check whether this device path include mac address device path.\r
      //\r
      if (!IsMacAddressDevicePath(ChildDevicePath, &IsNeedAdd)) {\r
        //\r
        // If this path not has mac address path, check the other.\r
        //\r
        continue;\r
      } else {\r
        //\r
        // If need to update the NETWORK_DEVICE_LIST_FORM, try to get more.\r
        //\r
        if ((NETWORK_DEVICE_LIST_FORM_ID == mNextShowFormId)) {\r
          if (IsNeedAdd) {\r
            (*ItemCount) += 1;\r
          }\r
          continue;\r
        } else {\r
          //\r
          // If need to update other form, return whether need to add to the menu.\r
          //\r
          goto Done;\r
        }\r
      }\r
    }\r
  }\r
\r
Done:\r
  if (OpenInfoBuffer != NULL) {\r
    FreePool (OpenInfoBuffer);\r
  }\r
  return IsNeedAdd;\r
}\r
\r
/**\r
  Get HiiHandle total number.\r
\r
  @param   HiiHandles              The input HiiHandle array.\r
\r
  @retval  the Hiihandle count.\r
\r
**/\r
UINTN\r
GetHiiHandleCount (\r
  IN EFI_HII_HANDLE              *HiiHandles\r
  )\r
{\r
  UINTN  Index;\r
\r
  for (Index = 0; HiiHandles[Index] != NULL; Index++) {\r
  }\r
\r
  return Index;\r
}\r
\r
/**\r
  Insert the new HiiHandle + FormsetGuid at the NewPair[InsertOffset].\r
\r
  @param   HiiHandles              The input HiiHandle array.\r
  @param   GuidLists               The input form set guid lists.\r
  @param   ArrayCount              The input array count, new array will be arraycount + 1 size.\r
  @param   Offset                  The current used HiiHandle's Offset.\r
  @param   FormSetGuid             The new found formset guid.\r
\r
**/\r
VOID\r
AdjustArrayData (\r
  IN OUT EFI_HII_HANDLE              **HiiHandles,\r
  IN OUT EFI_GUID                    ***GuidLists,\r
  IN     UINTN                       ArrayCount,\r
  IN     UINTN                       Offset,\r
  IN     EFI_GUID                    *FormSetGuid\r
  )\r
{\r
  EFI_HII_HANDLE              *NewHiiHandles;\r
  EFI_GUID                    **NewGuidLists;\r
\r
  //\r
  // +2 means include the new HiiHandle and the last empty NULL pointer.\r
  //\r
  NewHiiHandles = AllocateZeroPool ((ArrayCount + 2) * sizeof (EFI_HII_HANDLE));\r
  ASSERT (NewHiiHandles != NULL);\r
\r
  CopyMem (NewHiiHandles, *HiiHandles, Offset * sizeof (EFI_HII_HANDLE));\r
  NewHiiHandles[Offset] = NewHiiHandles[Offset - 1];\r
  CopyMem (NewHiiHandles + Offset + 1, *HiiHandles + Offset, (ArrayCount - Offset) * sizeof (EFI_HII_HANDLE));\r
\r
  NewGuidLists = AllocateZeroPool ((ArrayCount + 2) * sizeof (EFI_GUID *));\r
  ASSERT (NewGuidLists != NULL);\r
\r
  CopyMem (NewGuidLists, *GuidLists, Offset * sizeof (EFI_GUID *));\r
  NewGuidLists[Offset] = FormSetGuid;\r
\r
  FreePool (*HiiHandles);\r
  *HiiHandles = NewHiiHandles;\r
  FreePool (*GuidLists);\r
  *GuidLists = NewGuidLists;\r
}\r
\r
/**\r
  Call the browser and display the device manager to allow user\r
  to configure the platform.\r
\r
  This function create the dynamic content for device manager. It includes\r
  section header for all class of devices, one-of opcode to set VBIOS.\r
\r
  @retval  EFI_SUCCESS             Operation is successful.\r
  @return  Other values if failed to clean up the dynamic content from HII\r
           database.\r
\r
**/\r
EFI_STATUS\r
CallDeviceManager (\r
  VOID\r
  )\r
{\r
  EFI_STATUS                  Status;\r
  UINTN                       Index;\r
  EFI_STRING                  String;\r
  EFI_STRING_ID               Token;\r
  EFI_STRING_ID               TokenHelp;\r
  EFI_HII_HANDLE              *HiiHandles;\r
  EFI_HII_HANDLE              HiiHandle;\r
  EFI_STRING_ID               FormSetTitle;\r
  EFI_STRING_ID               FormSetHelp;\r
  EFI_BROWSER_ACTION_REQUEST  ActionRequest;\r
  VOID                        *StartOpCodeHandle;\r
  VOID                        *EndOpCodeHandle;\r
  EFI_IFR_GUID_LABEL          *StartLabel;\r
  EFI_IFR_GUID_LABEL          *EndLabel;\r
  UINTN                       NumHandles;\r
  EFI_HANDLE                  *DriverHealthHandles;\r
  BOOLEAN                     AddNetworkMenu;\r
  UINTN                       AddItemCount;\r
  UINTN                       NewStringLen;\r
  EFI_STRING                  NewStringTitle;\r
  EFI_GUID                    **GuidLists;\r
  UINTN                       HandleNum;\r
  UINTN                       SkipCount;\r
  EFI_GUID                    *FormSetGuid;\r
\r
  GuidLists     = NULL;\r
  HiiHandles    = NULL;\r
  Status        = EFI_SUCCESS;\r
  gCallbackKey  = 0;\r
  NumHandles    = 0;\r
  DriverHealthHandles = NULL;\r
  AddNetworkMenu = FALSE;\r
  AddItemCount   = 0;\r
  SkipCount      = 0;\r
  FormSetGuid    = NULL;\r
\r
  //\r
  // Connect all prior to entering the platform setup menu.\r
  //\r
  if (!gConnectAllHappened) {\r
    BdsLibConnectAllDriversToAllControllers ();\r
    gConnectAllHappened = TRUE;\r
  }\r
\r
  HiiHandle = gDeviceManagerPrivate.HiiHandle;\r
  if (HiiHandle == NULL) {\r
    //\r
    // Publish our HII data.\r
    //\r
    HiiHandle = HiiAddPackages (\r
                  &gDeviceManagerFormSetGuid,\r
                  gDeviceManagerPrivate.DriverHandle,\r
                  DeviceManagerVfrBin,\r
                  BdsDxeStrings,\r
                  NULL\r
                  );\r
    if (HiiHandle == NULL) {\r
      return EFI_OUT_OF_RESOURCES;\r
    }\r
\r
    gDeviceManagerPrivate.HiiHandle = HiiHandle;\r
  }\r
\r
  //\r
  // If need show the Network device list form, clear the old save list first.\r
  //\r
  if ((mNextShowFormId == NETWORK_DEVICE_LIST_FORM_ID) && (mMacDeviceList.CurListLen > 0)) {\r
    mMacDeviceList.CurListLen = 0;\r
  }\r
\r
  //\r
  // Update the network device form titile.\r
  //\r
  if (mNextShowFormId == NETWORK_DEVICE_FORM_ID) {\r
    String = HiiGetString (HiiHandle, STRING_TOKEN (STR_FORM_NETWORK_DEVICE_TITLE), NULL);\r
    NewStringLen = StrLen(mSelectedMacAddrString) * 2;\r
    NewStringLen += (StrLen(String) + 2) * 2;\r
    NewStringTitle = AllocatePool (NewStringLen);\r
    UnicodeSPrint (NewStringTitle, NewStringLen, L"%s %s", String, mSelectedMacAddrString);\r
    HiiSetString (HiiHandle, STRING_TOKEN (STR_FORM_NETWORK_DEVICE_TITLE), NewStringTitle, NULL);\r
    FreePool (String);\r
    FreePool (NewStringTitle);\r
  }\r
\r
  //\r
  // Allocate space for creation of UpdateData Buffer\r
  //\r
  StartOpCodeHandle = HiiAllocateOpCodeHandle ();\r
  ASSERT (StartOpCodeHandle != NULL);\r
\r
  EndOpCodeHandle = HiiAllocateOpCodeHandle ();\r
  ASSERT (EndOpCodeHandle != NULL);\r
\r
  //\r
  // Create Hii Extend Label OpCode as the start opcode\r
  //\r
  StartLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (StartOpCodeHandle, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));\r
  StartLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
  //\r
  // According to the next show Form id(mNextShowFormId) to decide which form need to update.\r
  //\r
  StartLabel->Number       = (UINT16) (LABEL_FORM_ID_OFFSET + mNextShowFormId);\r
\r
  //\r
  // Create Hii Extend Label OpCode as the end opcode\r
  //\r
  EndLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (EndOpCodeHandle, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));\r
  EndLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
  EndLabel->Number       = LABEL_END;\r
\r
  //\r
  // Get all the Hii handles\r
  //\r
  HiiHandles = HiiGetHiiHandles (NULL);\r
  ASSERT (HiiHandles != NULL);\r
\r
  HandleNum = GetHiiHandleCount (HiiHandles);\r
  GuidLists = AllocateZeroPool ((HandleNum + 1) * sizeof (EFI_GUID *));\r
  ASSERT (GuidLists != NULL);\r
\r
  //\r
  // Search for formset of each class type\r
  //\r
  for (Index = 0; HiiHandles[Index] != NULL; Index++) {\r
    //\r
    //  The QuestionId in the form which will call the driver form has this asssumption.\r
    //  QuestionId = Handle Index + NETWORK_DEVICE_LIST_KEY_OFFSET;\r
    //  Different QuestionId at least has the section of NETWORK_DEVICE_LIST_KEY_OFFSET.\r
    //\r
    ASSERT(Index < MAX_KEY_SECTION_LEN);\r
\r
    if (!ExtractDisplayedHiiFormFromHiiHandle (HiiHandles[Index], &gEfiHiiPlatformSetupFormsetGuid, SkipCount, &FormSetTitle, &FormSetHelp, &FormSetGuid)) {\r
      SkipCount = 0;\r
      continue;\r
    }\r
\r
    //\r
    // One HiiHandle has more than one formset can be shown,\r
    // Insert a new pair of HiiHandle + Guid to the HiiHandles and GuidLists list.\r
    //\r
    if (SkipCount > 0) {\r
      AdjustArrayData (&HiiHandles, &GuidLists, HandleNum, Index + 1, FormSetGuid);\r
      HandleNum ++;\r
      Index ++;\r
    }\r
\r
    String = HiiGetString (HiiHandles[Index], FormSetTitle, NULL);\r
    if (String == NULL) {\r
      String = HiiGetString (HiiHandle, STR_MISSING_STRING, NULL);\r
      ASSERT (String != NULL);\r
    }\r
    Token = HiiSetString (HiiHandle, 0, String, NULL);\r
    FreePool (String);\r
\r
    String = HiiGetString (HiiHandles[Index], FormSetHelp, NULL);\r
    if (String == NULL) {\r
      String = HiiGetString (HiiHandle, STR_MISSING_STRING, NULL);\r
      ASSERT (String != NULL);\r
    }\r
    TokenHelp = HiiSetString (HiiHandle, 0, String, NULL);\r
    FreePool (String);\r
\r
    //\r
    // Network device process\r
    //\r
    if (IsNeedAddNetworkMenu (HiiHandles[Index], &AddItemCount)) {\r
      if (mNextShowFormId == DEVICE_MANAGER_FORM_ID) {\r
        //\r
        // Only show one menu item "Network Config" in the device manger form.\r
        //\r
        if (!AddNetworkMenu) {\r
          AddNetworkMenu = TRUE;\r
          HiiCreateGotoOpCode (\r
            StartOpCodeHandle,\r
            INVALID_FORM_ID,\r
            STRING_TOKEN (STR_FORM_NETWORK_DEVICE_LIST_TITLE),\r
            STRING_TOKEN (STR_FORM_NETWORK_DEVICE_LIST_HELP),\r
            EFI_IFR_FLAG_CALLBACK,\r
            (EFI_QUESTION_ID) QUESTION_NETWORK_DEVICE_ID\r
            );\r
        }\r
      } else if (mNextShowFormId == NETWORK_DEVICE_LIST_FORM_ID) {\r
        //\r
        // In network device list form, same mac address device only show one menu.\r
        //\r
        while (AddItemCount > 0) {\r
            HiiCreateGotoOpCode (\r
              StartOpCodeHandle,\r
              INVALID_FORM_ID,\r
              mMacDeviceList.NodeList[mMacDeviceList.CurListLen - AddItemCount].PromptId,\r
              STRING_TOKEN (STR_NETWORK_DEVICE_HELP),\r
              EFI_IFR_FLAG_CALLBACK,\r
              mMacDeviceList.NodeList[mMacDeviceList.CurListLen - AddItemCount].QuestionId\r
              );\r
            AddItemCount -= 1;\r
          }\r
      } else if (mNextShowFormId == NETWORK_DEVICE_FORM_ID) {\r
        //\r
        // In network device form, only the selected mac address device need to be show.\r
        //\r
        HiiCreateGotoOpCode (\r
          StartOpCodeHandle,\r
          INVALID_FORM_ID,\r
          Token,\r
          TokenHelp,\r
          EFI_IFR_FLAG_CALLBACK,\r
          (EFI_QUESTION_ID) (Index + DEVICE_KEY_OFFSET)\r
          );\r
      }\r
    } else {\r
      //\r
      //\r
      // Not network device process, only need to show at device manger form.\r
      //\r
      if (mNextShowFormId == DEVICE_MANAGER_FORM_ID) {\r
        HiiCreateGotoOpCode (\r
          StartOpCodeHandle,\r
          INVALID_FORM_ID,\r
          Token,\r
          TokenHelp,\r
          EFI_IFR_FLAG_CALLBACK,\r
          (EFI_QUESTION_ID) (Index + DEVICE_KEY_OFFSET)\r
          );\r
      }\r
    }\r
\r
    //\r
    // Try to find more formset in this HiiHandle.\r
    //\r
    SkipCount++;\r
    Index--;\r
  }\r
\r
  Status = gBS->LocateHandleBuffer (\r
                ByProtocol,\r
                &gEfiDriverHealthProtocolGuid,\r
                NULL,\r
                &NumHandles,\r
                &DriverHealthHandles\r
                );\r
\r
  //\r
  // If there are no drivers installed driver health protocol, do not create driver health entry in UI\r
  //\r
  if (NumHandles != 0) {\r
    //\r
    // If driver health protocol is installed, create Driver Health subtitle and entry\r
    //\r
    HiiCreateSubTitleOpCode (StartOpCodeHandle, STRING_TOKEN (STR_DM_DRIVER_HEALTH_TITLE), 0, 0, 0);\r
    HiiCreateGotoOpCode (\r
      StartOpCodeHandle,\r
      DRIVER_HEALTH_FORM_ID,\r
      STRING_TOKEN(STR_DRIVER_HEALTH_ALL_HEALTHY),      // Prompt text\r
      STRING_TOKEN(STR_DRIVER_HEALTH_STATUS_HELP),      // Help text\r
      EFI_IFR_FLAG_CALLBACK,\r
      DEVICE_MANAGER_KEY_DRIVER_HEALTH                  // Question ID\r
      );\r
\r
    //\r
    // Check All Driver health status\r
    //\r
    if (!PlaformHealthStatusCheck ()) {\r
      //\r
      // At least one driver in the platform are not in healthy status\r
      //\r
      HiiSetString (HiiHandle, STRING_TOKEN (STR_DRIVER_HEALTH_ALL_HEALTHY), GetStringById (STRING_TOKEN (STR_DRIVER_NOT_HEALTH)), NULL);\r
    } else {\r
      //\r
      // For the string of STR_DRIVER_HEALTH_ALL_HEALTHY previously has been updated and we need to update it while re-entry.\r
      //\r
      HiiSetString (HiiHandle, STRING_TOKEN (STR_DRIVER_HEALTH_ALL_HEALTHY), GetStringById (STRING_TOKEN (STR_DRIVER_HEALTH_ALL_HEALTHY)), NULL);\r
    }\r
  }\r
\r
  HiiUpdateForm (\r
    HiiHandle,\r
    &gDeviceManagerFormSetGuid,\r
    mNextShowFormId,\r
    StartOpCodeHandle,\r
    EndOpCodeHandle\r
    );\r
\r
  ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
  Status = gFormBrowser2->SendForm (\r
                           gFormBrowser2,\r
                           &HiiHandle,\r
                           1,\r
                           &gDeviceManagerFormSetGuid,\r
                           mNextShowFormId,\r
                           NULL,\r
                           &ActionRequest\r
                           );\r
  if (ActionRequest == EFI_BROWSER_ACTION_REQUEST_RESET) {\r
    EnableResetRequired ();\r
  }\r
\r
  //\r
  // We will have returned from processing a callback, selected\r
  // a target to display\r
  //\r
  if ((gCallbackKey >= DEVICE_KEY_OFFSET)) {\r
    ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
    Status = gFormBrowser2->SendForm (\r
                             gFormBrowser2,\r
                             &HiiHandles[gCallbackKey - DEVICE_KEY_OFFSET],\r
                             1,\r
                             GuidLists[gCallbackKey - DEVICE_KEY_OFFSET],\r
                             0,\r
                             NULL,\r
                             &ActionRequest\r
                             );\r
\r
    if (ActionRequest == EFI_BROWSER_ACTION_REQUEST_RESET) {\r
      EnableResetRequired ();\r
    }\r
\r
    //\r
    // Force return to Device Manager\r
    //\r
    gCallbackKey = FRONT_PAGE_KEY_DEVICE_MANAGER;\r
    goto Done;\r
  }\r
\r
  //\r
  // Driver Health item chose.\r
  //\r
  if (gCallbackKey == DEVICE_MANAGER_KEY_DRIVER_HEALTH) {\r
    CallDriverHealth ();\r
    //\r
    // Force return to Device Manager\r
    //\r
    gCallbackKey = FRONT_PAGE_KEY_DEVICE_MANAGER;\r
    goto Done;\r
  }\r
\r
  //\r
  // Enter from device manager and into the network device list.\r
  //\r
  if (gCallbackKey == QUESTION_NETWORK_DEVICE_ID) {\r
    mNextShowFormId = NETWORK_DEVICE_LIST_FORM_ID;\r
    gCallbackKey = FRONT_PAGE_KEY_DEVICE_MANAGER;\r
    goto Done;\r
  }\r
\r
  //\r
  // In this case, go from the network device list to the specify device.\r
  //\r
  if ((gCallbackKey < MAX_KEY_SECTION_LEN + NETWORK_DEVICE_LIST_KEY_OFFSET ) && (gCallbackKey >= NETWORK_DEVICE_LIST_KEY_OFFSET)) {\r
    mNextShowFormId = NETWORK_DEVICE_FORM_ID;\r
    gCallbackKey = FRONT_PAGE_KEY_DEVICE_MANAGER;\r
    goto Done;\r
  }\r
\r
  //\r
  // Select the ESC, the gCallbackKey == 0.\r
  //\r
  if(mNextShowFormId - 1 < DEVICE_MANAGER_FORM_ID) {\r
    mNextShowFormId = DEVICE_MANAGER_FORM_ID;\r
  } else {\r
    mNextShowFormId = (UINT16) (mNextShowFormId - 1);\r
    gCallbackKey = FRONT_PAGE_KEY_DEVICE_MANAGER;\r
  }\r
\r
Done:\r
  //\r
  // Remove our packagelist from HII database.\r
  //\r
  HiiRemovePackages (HiiHandle);\r
  gDeviceManagerPrivate.HiiHandle = NULL;\r
\r
  HiiFreeOpCodeHandle (StartOpCodeHandle);\r
  HiiFreeOpCodeHandle (EndOpCodeHandle);\r
  FreePool (HiiHandles);\r
\r
  for (Index = 0; Index < HandleNum; Index++) {\r
    if (GuidLists[Index] != NULL) {\r
      FreePool (GuidLists[Index]);\r
    }\r
  }\r
  FreePool (GuidLists);\r
\r
  return Status;\r
}\r
\r
/**\r
  This function is invoked if user selected a interactive opcode from Driver Health's\r
  Formset. The decision by user is saved to gCallbackKey for later processing.\r
\r
  @param This            Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param Action          Specifies the type of action taken by the browser.\r
  @param QuestionId      A unique value which is sent to the original exporting driver\r
                         so that it can identify the type of data to expect.\r
  @param Type            The type of value for the question.\r
  @param Value           A pointer to the data being sent to the original exporting driver.\r
  @param ActionRequest   On return, points to the action requested by the callback function.\r
\r
  @retval  EFI_SUCCESS           The callback successfully handled the action.\r
  @retval  EFI_INVALID_PARAMETER The setup browser call this function with invalid parameters.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DriverHealthCallback (\r
  IN  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL   *This,\r
  IN  EFI_BROWSER_ACTION                     Action,\r
  IN  EFI_QUESTION_ID                        QuestionId,\r
  IN  UINT8                                  Type,\r
  IN  EFI_IFR_TYPE_VALUE                     *Value,\r
  OUT EFI_BROWSER_ACTION_REQUEST             *ActionRequest\r
  )\r
{\r
  if (Action == EFI_BROWSER_ACTION_CHANGED) {\r
    if ((Value == NULL) || (ActionRequest == NULL)) {\r
      return EFI_INVALID_PARAMETER;\r
    }\r
\r
    gCallbackKey = QuestionId;\r
\r
    //\r
    // Request to exit SendForm(), so as to switch to selected form\r
    //\r
    *ActionRequest = EFI_BROWSER_ACTION_REQUEST_EXIT;\r
\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // All other action return unsupported.\r
  //\r
  return EFI_UNSUPPORTED;\r
}\r
\r
/**\r
  Collect and display the platform's driver health relative information, allow user to do interactive\r
  operation while the platform is unhealthy.\r
\r
  This function display a form which divided into two parts. The one list all modules which has installed\r
  driver health protocol. The list usually contain driver name, controller name, and it's health info.\r
  While the driver name can't be retrieved, will use device path as backup. The other part of the form provide\r
  a choice to the user to repair all platform.\r
\r
**/\r
VOID\r
CallDriverHealth (\r
  VOID\r
  )\r
{\r
  EFI_STATUS                  Status;\r
  EFI_HII_HANDLE              HiiHandle;\r
  EFI_BROWSER_ACTION_REQUEST  ActionRequest;\r
  EFI_IFR_GUID_LABEL          *StartLabel;\r
  EFI_IFR_GUID_LABEL          *StartLabelRepair;\r
  EFI_IFR_GUID_LABEL          *EndLabel;\r
  EFI_IFR_GUID_LABEL          *EndLabelRepair;\r
  VOID                        *StartOpCodeHandle;\r
  VOID                        *EndOpCodeHandle;\r
  VOID                        *StartOpCodeHandleRepair;\r
  VOID                        *EndOpCodeHandleRepair;\r
  UINTN                       Index;\r
  EFI_STRING_ID               Token;\r
  EFI_STRING_ID               TokenHelp;\r
  EFI_STRING                  String;\r
  EFI_STRING                  TmpString;\r
  EFI_STRING                  DriverName;\r
  EFI_STRING                  ControllerName;\r
  LIST_ENTRY                  DriverHealthList;\r
  DRIVER_HEALTH_INFO          *DriverHealthInfo;\r
  LIST_ENTRY                  *Link;\r
  EFI_DEVICE_PATH_PROTOCOL    *DriverDevicePath;\r
  BOOLEAN                     RebootRequired;\r
  BOOLEAN                     IsControllerNameEmpty;\r
  UINTN                       StringSize;\r
\r
  Index               = 0;\r
  DriverHealthInfo    = NULL;\r
  DriverDevicePath    = NULL;\r
  IsControllerNameEmpty = FALSE;\r
  InitializeListHead (&DriverHealthList);\r
\r
  HiiHandle = gDeviceManagerPrivate.DriverHealthHiiHandle;\r
  if (HiiHandle == NULL) {\r
    //\r
    // Publish Driver Health HII data.\r
    //\r
    HiiHandle = HiiAddPackages (\r
                  &gDeviceManagerFormSetGuid,\r
                  gDeviceManagerPrivate.DriverHealthHandle,\r
                  DriverHealthVfrBin,\r
                  BdsDxeStrings,\r
                  NULL\r
                  );\r
    if (HiiHandle == NULL) {\r
      return;\r
    }\r
\r
    gDeviceManagerPrivate.DriverHealthHiiHandle = HiiHandle;\r
  }\r
\r
  //\r
  // Allocate space for creation of UpdateData Buffer\r
  //\r
  StartOpCodeHandle = HiiAllocateOpCodeHandle ();\r
  ASSERT (StartOpCodeHandle != NULL);\r
\r
  EndOpCodeHandle = HiiAllocateOpCodeHandle ();\r
  ASSERT (EndOpCodeHandle != NULL);\r
\r
  StartOpCodeHandleRepair = HiiAllocateOpCodeHandle ();\r
  ASSERT (StartOpCodeHandleRepair != NULL);\r
\r
  EndOpCodeHandleRepair = HiiAllocateOpCodeHandle ();\r
  ASSERT (EndOpCodeHandleRepair != NULL);\r
\r
  //\r
  // Create Hii Extend Label OpCode as the start opcode\r
  //\r
  StartLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (StartOpCodeHandle, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));\r
  StartLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
  StartLabel->Number       = LABEL_DRIVER_HEALTH;\r
\r
  //\r
  // Create Hii Extend Label OpCode as the start opcode\r
  //\r
  StartLabelRepair = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (StartOpCodeHandleRepair, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));\r
  StartLabelRepair->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
  StartLabelRepair->Number       = LABEL_DRIVER_HEALTH_REAPIR_ALL;\r
\r
  //\r
  // Create Hii Extend Label OpCode as the end opcode\r
  //\r
  EndLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (EndOpCodeHandle, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));\r
  EndLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
  EndLabel->Number       = LABEL_DRIVER_HEALTH_END;\r
\r
  //\r
  // Create Hii Extend Label OpCode as the end opcode\r
  //\r
  EndLabelRepair = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (EndOpCodeHandleRepair, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));\r
  EndLabelRepair->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
  EndLabelRepair->Number       = LABEL_DRIVER_HEALTH_REAPIR_ALL_END;\r
\r
  HiiCreateSubTitleOpCode (StartOpCodeHandle, STRING_TOKEN (STR_DH_STATUS_LIST), 0, 0, 1);\r
\r
  Status = GetAllControllersHealthStatus (&DriverHealthList);\r
  ASSERT (Status != EFI_OUT_OF_RESOURCES);\r
\r
  Link = GetFirstNode (&DriverHealthList);\r
\r
  while (!IsNull (&DriverHealthList, Link)) {\r
    DriverHealthInfo = DEVICE_MANAGER_HEALTH_INFO_FROM_LINK (Link);\r
\r
    Status = DriverHealthGetDriverName (DriverHealthInfo->DriverHandle, &DriverName);\r
    if (EFI_ERROR (Status)) {\r
      //\r
      // Can not get the Driver name, so use the Device path\r
      //\r
      DriverDevicePath = DevicePathFromHandle (DriverHealthInfo->DriverHandle);\r
      DriverName       = DevicePathToStr (DriverDevicePath);\r
    }\r
    StringSize = StrSize (DriverName);\r
\r
    Status = DriverHealthGetControllerName (\r
               DriverHealthInfo->DriverHandle,\r
               DriverHealthInfo->ControllerHandle,\r
               DriverHealthInfo->ChildHandle,\r
               &ControllerName\r
               );\r
\r
    if (!EFI_ERROR (Status)) {\r
      IsControllerNameEmpty = FALSE;\r
      StringSize += StrLen (L"    ") * sizeof(CHAR16);\r
      StringSize += StrLen (ControllerName) * sizeof(CHAR16);\r
    } else {\r
      IsControllerNameEmpty = TRUE;\r
    }\r
\r
    //\r
    // Add the message of the Module itself provided after the string item.\r
    //\r
    if ((DriverHealthInfo->MessageList != NULL) && (DriverHealthInfo->MessageList->StringId != 0)) {\r
       TmpString = HiiGetString (\r
                     DriverHealthInfo->MessageList->HiiHandle,\r
                     DriverHealthInfo->MessageList->StringId,\r
                     NULL\r
                     );\r
       ASSERT (TmpString != NULL);\r
\r
       StringSize += StrLen (L"    ") * sizeof(CHAR16);\r
       StringSize += StrLen (TmpString) * sizeof(CHAR16);\r
\r
       String = (EFI_STRING) AllocateZeroPool (StringSize);\r
       ASSERT (String != NULL);\r
\r
       StrCpyS (String, StringSize / sizeof(CHAR16), DriverName);\r
       if (!IsControllerNameEmpty) {\r
        StrCatS (String, StringSize / sizeof(CHAR16), L"    ");\r
        StrCatS (String, StringSize / sizeof(CHAR16), ControllerName);\r
       }\r
\r
       StrCatS (String, StringSize / sizeof(CHAR16), L"    ");\r
       StrCatS (String, StringSize / sizeof(CHAR16), TmpString);\r
\r
    } else {\r
      //\r
      // Update the string will be displayed base on the driver's health status\r
      //\r
      switch(DriverHealthInfo->HealthStatus) {\r
      case EfiDriverHealthStatusRepairRequired:\r
        TmpString = GetStringById (STRING_TOKEN (STR_REPAIR_REQUIRED));\r
        break;\r
      case EfiDriverHealthStatusConfigurationRequired:\r
        TmpString = GetStringById (STRING_TOKEN (STR_CONFIGURATION_REQUIRED));\r
        break;\r
      case EfiDriverHealthStatusFailed:\r
        TmpString = GetStringById (STRING_TOKEN (STR_OPERATION_FAILED));\r
        break;\r
      case EfiDriverHealthStatusReconnectRequired:\r
        TmpString = GetStringById (STRING_TOKEN (STR_RECONNECT_REQUIRED));\r
        break;\r
      case EfiDriverHealthStatusRebootRequired:\r
        TmpString = GetStringById (STRING_TOKEN (STR_REBOOT_REQUIRED));\r
        break;\r
      default:\r
        TmpString = GetStringById (STRING_TOKEN (STR_DRIVER_HEALTH_HEALTHY));\r
        break;\r
      }\r
      ASSERT (TmpString != NULL);\r
\r
      StringSize += StrLen (TmpString) * sizeof(CHAR16);\r
\r
      String = (EFI_STRING) AllocateZeroPool (StringSize);\r
      ASSERT (String != NULL);\r
\r
      StrCpyS (String, StringSize / sizeof (CHAR16), DriverName);\r
      if (!IsControllerNameEmpty) {\r
        StrCatS (String, StringSize / sizeof (CHAR16), L"    ");\r
        StrCatS (String, StringSize / sizeof (CHAR16), ControllerName);\r
      }\r
\r
      StrCatS (String, StringSize / sizeof (CHAR16), TmpString);\r
    }\r
\r
    FreePool (TmpString);\r
\r
    Token = HiiSetString (HiiHandle, 0, String, NULL);\r
    FreePool (String);\r
\r
    TokenHelp = HiiSetString (HiiHandle, 0, GetStringById( STRING_TOKEN (STR_DH_REPAIR_SINGLE_HELP)), NULL);\r
\r
    HiiCreateActionOpCode (\r
      StartOpCodeHandle,\r
      (EFI_QUESTION_ID) (Index + DRIVER_HEALTH_KEY_OFFSET),\r
      Token,\r
      TokenHelp,\r
      EFI_IFR_FLAG_CALLBACK,\r
      0\r
      );\r
    Index++;\r
    Link = GetNextNode (&DriverHealthList, Link);\r
  }\r
\r
  //\r
  // Add End Opcode for Subtitle\r
  //\r
  HiiCreateEndOpCode (StartOpCodeHandle);\r
\r
  HiiCreateSubTitleOpCode (StartOpCodeHandleRepair, STRING_TOKEN (STR_DRIVER_HEALTH_REPAIR_ALL), 0, 0, 1);\r
  TokenHelp = HiiSetString (HiiHandle, 0, GetStringById( STRING_TOKEN (STR_DH_REPAIR_ALL_HELP)), NULL);\r
\r
  if (PlaformHealthStatusCheck ()) {\r
    //\r
    // No action need to do for the platform\r
    //\r
    Token = HiiSetString (HiiHandle, 0, GetStringById( STRING_TOKEN (STR_DRIVER_HEALTH_ALL_HEALTHY)), NULL);\r
    HiiCreateActionOpCode (\r
      StartOpCodeHandleRepair,\r
      0,\r
      Token,\r
      TokenHelp,\r
      EFI_IFR_FLAG_READ_ONLY,\r
      0\r
      );\r
  } else {\r
    //\r
    // Create ActionOpCode only while the platform need to do health related operation.\r
    //\r
    Token = HiiSetString (HiiHandle, 0, GetStringById( STRING_TOKEN (STR_DH_REPAIR_ALL_TITLE)), NULL);\r
    HiiCreateActionOpCode (\r
      StartOpCodeHandleRepair,\r
      (EFI_QUESTION_ID) DRIVER_HEALTH_REPAIR_ALL_KEY,\r
      Token,\r
      TokenHelp,\r
      EFI_IFR_FLAG_CALLBACK,\r
      0\r
      );\r
  }\r
\r
  HiiCreateEndOpCode (StartOpCodeHandleRepair);\r
\r
  Status = HiiUpdateForm (\r
             HiiHandle,\r
             &gDriverHealthFormSetGuid,\r
             DRIVER_HEALTH_FORM_ID,\r
             StartOpCodeHandle,\r
             EndOpCodeHandle\r
             );\r
  ASSERT (Status != EFI_NOT_FOUND);\r
  ASSERT (Status != EFI_BUFFER_TOO_SMALL);\r
\r
  Status = HiiUpdateForm (\r
            HiiHandle,\r
            &gDriverHealthFormSetGuid,\r
            DRIVER_HEALTH_FORM_ID,\r
            StartOpCodeHandleRepair,\r
            EndOpCodeHandleRepair\r
    );\r
  ASSERT (Status != EFI_NOT_FOUND);\r
  ASSERT (Status != EFI_BUFFER_TOO_SMALL);\r
\r
  ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
  Status = gFormBrowser2->SendForm (\r
                           gFormBrowser2,\r
                           &HiiHandle,\r
                           1,\r
                           &gDriverHealthFormSetGuid,\r
                           DRIVER_HEALTH_FORM_ID,\r
                           NULL,\r
                           &ActionRequest\r
                           );\r
  if (ActionRequest == EFI_BROWSER_ACTION_REQUEST_RESET) {\r
    EnableResetRequired ();\r
  }\r
\r
  //\r
  // We will have returned from processing a callback - user either hit ESC to exit, or selected\r
  // a target to display.\r
  // Process the diver health status states here.\r
  //\r
  if (gCallbackKey >= DRIVER_HEALTH_KEY_OFFSET && gCallbackKey != DRIVER_HEALTH_REPAIR_ALL_KEY) {\r
    ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
\r
    Link = GetFirstNode (&DriverHealthList);\r
    Index = 0;\r
\r
    while (!IsNull (&DriverHealthList, Link)) {\r
      //\r
      // Got the item relative node in the List\r
      //\r
      if (Index == (gCallbackKey - DRIVER_HEALTH_KEY_OFFSET)) {\r
        DriverHealthInfo = DEVICE_MANAGER_HEALTH_INFO_FROM_LINK (Link);\r
        //\r
        // Process the driver's healthy status for the specify module\r
        //\r
        RebootRequired = FALSE;\r
        ProcessSingleControllerHealth (\r
          DriverHealthInfo->DriverHealth,\r
          DriverHealthInfo->ControllerHandle,\r
          DriverHealthInfo->ChildHandle,\r
          DriverHealthInfo->HealthStatus,\r
          &(DriverHealthInfo->MessageList),\r
          DriverHealthInfo->HiiHandle,\r
          &RebootRequired\r
          );\r
        if (RebootRequired) {\r
          gRT->ResetSystem (EfiResetWarm, EFI_SUCCESS, 0, NULL);\r
        }\r
        break;\r
      }\r
      Index++;\r
      Link = GetNextNode (&DriverHealthList, Link);\r
    }\r
\r
    if (ActionRequest == EFI_BROWSER_ACTION_REQUEST_RESET) {\r
      EnableResetRequired ();\r
    }\r
\r
    //\r
    // Force return to the form of Driver Health in Device Manager\r
    //\r
    gCallbackKey = DRIVER_HEALTH_RETURN_KEY;\r
  }\r
\r
  //\r
  // Repair the whole platform\r
  //\r
  if (gCallbackKey == DRIVER_HEALTH_REPAIR_ALL_KEY) {\r
    ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
\r
    PlatformRepairAll (&DriverHealthList);\r
\r
    gCallbackKey = DRIVER_HEALTH_RETURN_KEY;\r
  }\r
\r
  //\r
  // Remove driver health packagelist from HII database.\r
  //\r
  HiiRemovePackages (HiiHandle);\r
  gDeviceManagerPrivate.DriverHealthHiiHandle = NULL;\r
\r
  //\r
  // Free driver health info list\r
  //\r
  while (!IsListEmpty (&DriverHealthList)) {\r
\r
    Link = GetFirstNode(&DriverHealthList);\r
    DriverHealthInfo = DEVICE_MANAGER_HEALTH_INFO_FROM_LINK (Link);\r
    RemoveEntryList (Link);\r
\r
    if (DriverHealthInfo->MessageList != NULL) {\r
      FreePool(DriverHealthInfo->MessageList);\r
      FreePool (DriverHealthInfo);\r
    }\r
  }\r
\r
  HiiFreeOpCodeHandle (StartOpCodeHandle);\r
  HiiFreeOpCodeHandle (EndOpCodeHandle);\r
  HiiFreeOpCodeHandle (StartOpCodeHandleRepair);\r
  HiiFreeOpCodeHandle (EndOpCodeHandleRepair);\r
\r
  if (gCallbackKey == DRIVER_HEALTH_RETURN_KEY) {\r
    //\r
    // Force return to Driver Health Form\r
    //\r
    gCallbackKey = DEVICE_MANAGER_KEY_DRIVER_HEALTH;\r
    CallDriverHealth ();\r
  }\r
}\r
\r
\r
/**\r
  Check the Driver Health status of a single controller and try to process it if not healthy.\r
\r
  This function called by CheckAllControllersHealthStatus () function in order to process a specify\r
  contoller's health state.\r
\r
  @param DriverHealthList   A Pointer to the list contain all of the platform driver health information.\r
  @param DriverHandle       The handle of driver.\r
  @param ControllerHandle   The class guid specifies which form set will be displayed.\r
  @param ChildHandle        The handle of the child controller to retrieve the health\r
                            status on.  This is an optional parameter that may be NULL.\r
  @param DriverHealth       A pointer to the EFI_DRIVER_HEALTH_PROTOCOL instance.\r
  @param HealthStatus       The health status of the controller.\r
\r
  @retval EFI_INVALID_PARAMETER   HealthStatus or DriverHealth is NULL.\r
  @retval HealthStatus            The Health status of specify controller.\r
  @retval EFI_OUT_OF_RESOURCES    The list of Driver Health Protocol handles can not be retrieved.\r
  @retval EFI_NOT_FOUND           No controller in the platform install Driver Health Protocol.\r
  @retval EFI_SUCCESS             The Health related operation has been taken successfully.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
GetSingleControllerHealthStatus (\r
  IN OUT LIST_ENTRY                   *DriverHealthList,\r
  IN EFI_HANDLE                       DriverHandle,\r
  IN EFI_HANDLE                       ControllerHandle,  OPTIONAL\r
  IN EFI_HANDLE                       ChildHandle,       OPTIONAL\r
  IN EFI_DRIVER_HEALTH_PROTOCOL       *DriverHealth,\r
  IN EFI_DRIVER_HEALTH_STATUS         *HealthStatus\r
  )\r
{\r
  EFI_STATUS                     Status;\r
  EFI_DRIVER_HEALTH_HII_MESSAGE  *MessageList;\r
  EFI_HII_HANDLE                 FormHiiHandle;\r
  DRIVER_HEALTH_INFO             *DriverHealthInfo;\r
\r
  if (HealthStatus == NULL) {\r
    //\r
    // If HealthStatus is NULL, then return EFI_INVALID_PARAMETER\r
    //\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Assume the HealthStatus is healthy\r
  //\r
  *HealthStatus = EfiDriverHealthStatusHealthy;\r
\r
  if (DriverHealth == NULL) {\r
    //\r
    // If DriverHealth is NULL, then return EFI_INVALID_PARAMETER\r
    //\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  if (ControllerHandle == NULL) {\r
    //\r
    // If ControllerHandle is NULL, the return the cumulative health status of the driver\r
    //\r
    Status = DriverHealth->GetHealthStatus (DriverHealth, NULL, NULL, HealthStatus, NULL, NULL);\r
    if (*HealthStatus == EfiDriverHealthStatusHealthy) {\r
      //\r
      // Add the driver health related information into the list\r
      //\r
      DriverHealthInfo = AllocateZeroPool (sizeof (DRIVER_HEALTH_INFO));\r
      if (DriverHealthInfo == NULL) {\r
        return EFI_OUT_OF_RESOURCES;\r
      }\r
\r
      DriverHealthInfo->Signature          = DEVICE_MANAGER_DRIVER_HEALTH_INFO_SIGNATURE;\r
      DriverHealthInfo->DriverHandle       = DriverHandle;\r
      DriverHealthInfo->ControllerHandle   = NULL;\r
      DriverHealthInfo->ChildHandle        = NULL;\r
      DriverHealthInfo->HiiHandle          = NULL;\r
      DriverHealthInfo->DriverHealth       = DriverHealth;\r
      DriverHealthInfo->MessageList        = NULL;\r
      DriverHealthInfo->HealthStatus       = *HealthStatus;\r
\r
      InsertTailList (DriverHealthList, &DriverHealthInfo->Link);\r
    }\r
    return Status;\r
  }\r
\r
  MessageList   = NULL;\r
  FormHiiHandle = NULL;\r
\r
  //\r
  // Collect the health status with the optional HII message list\r
  //\r
  Status = DriverHealth->GetHealthStatus (DriverHealth, ControllerHandle, ChildHandle, HealthStatus, &MessageList, &FormHiiHandle);\r
\r
  if (EFI_ERROR (Status)) {\r
    //\r
    // If the health status could not be retrieved, then return immediately\r
    //\r
    return Status;\r
  }\r
\r
  //\r
  // Add the driver health related information into the list\r
  //\r
  DriverHealthInfo = AllocateZeroPool (sizeof (DRIVER_HEALTH_INFO));\r
  if (DriverHealthInfo == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  DriverHealthInfo->Signature          = DEVICE_MANAGER_DRIVER_HEALTH_INFO_SIGNATURE;\r
  DriverHealthInfo->DriverHandle       = DriverHandle;\r
  DriverHealthInfo->ControllerHandle   = ControllerHandle;\r
  DriverHealthInfo->ChildHandle        = ChildHandle;\r
  DriverHealthInfo->HiiHandle          = FormHiiHandle;\r
  DriverHealthInfo->DriverHealth       = DriverHealth;\r
  DriverHealthInfo->MessageList        = MessageList;\r
  DriverHealthInfo->HealthStatus       = *HealthStatus;\r
\r
  InsertTailList (DriverHealthList, &DriverHealthInfo->Link);\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Collects all the EFI Driver Health Protocols currently present in the EFI Handle Database,\r
  and queries each EFI Driver Health Protocol to determine if one or more of the controllers\r
  managed by each EFI Driver Health Protocol instance are not healthy.\r
\r
  @param DriverHealthList   A Pointer to the list contain all of the platform driver health\r
                            information.\r
\r
  @retval    EFI_NOT_FOUND         No controller in the platform install Driver Health Protocol.\r
  @retval    EFI_SUCCESS           All the controllers in the platform are healthy.\r
  @retval    EFI_OUT_OF_RESOURCES  The list of Driver Health Protocol handles can not be retrieved.\r
\r
**/\r
EFI_STATUS\r
GetAllControllersHealthStatus (\r
  IN OUT LIST_ENTRY  *DriverHealthList\r
  )\r
{\r
  EFI_STATUS                 Status;\r
  UINTN                      NumHandles;\r
  EFI_HANDLE                 *DriverHealthHandles;\r
  EFI_DRIVER_HEALTH_PROTOCOL *DriverHealth;\r
  EFI_DRIVER_HEALTH_STATUS   HealthStatus;\r
  UINTN                      DriverHealthIndex;\r
  EFI_HANDLE                 *Handles;\r
  UINTN                      HandleCount;\r
  UINTN                      ControllerIndex;\r
  UINTN                      ChildIndex;\r
\r
  //\r
  // Initialize local variables\r
  //\r
  Handles                 = NULL;\r
  DriverHealthHandles     = NULL;\r
  NumHandles              = 0;\r
  HandleCount             = 0;\r
\r
  HealthStatus = EfiDriverHealthStatusHealthy;\r
\r
  Status = gBS->LocateHandleBuffer (\r
                  ByProtocol,\r
                  &gEfiDriverHealthProtocolGuid,\r
                  NULL,\r
                  &NumHandles,\r
                  &DriverHealthHandles\r
                  );\r
\r
  if (Status == EFI_NOT_FOUND || NumHandles == 0) {\r
    //\r
    // If there are no Driver Health Protocols handles, then return EFI_NOT_FOUND\r
    //\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  if (EFI_ERROR (Status) || DriverHealthHandles == NULL) {\r
    //\r
    // If the list of Driver Health Protocol handles can not be retrieved, then\r
    // return EFI_OUT_OF_RESOURCES\r
    //\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  //\r
  // Check the health status of all controllers in the platform\r
  // Start by looping through all the Driver Health Protocol handles in the handle database\r
  //\r
  for (DriverHealthIndex = 0; DriverHealthIndex < NumHandles; DriverHealthIndex++) {\r
    //\r
    // Skip NULL Driver Health Protocol handles\r
    //\r
    if (DriverHealthHandles[DriverHealthIndex] == NULL) {\r
      continue;\r
    }\r
\r
    //\r
    // Retrieve the Driver Health Protocol from DriverHandle\r
    //\r
    Status = gBS->HandleProtocol (\r
                    DriverHealthHandles[DriverHealthIndex],\r
                    &gEfiDriverHealthProtocolGuid,\r
                    (VOID **)&DriverHealth\r
                    );\r
    if (EFI_ERROR (Status)) {\r
      //\r
      // If the Driver Health Protocol can not be retrieved, then skip to the next\r
      // Driver Health Protocol handle\r
      //\r
      continue;\r
    }\r
\r
    //\r
    // Check the health of all the controllers managed by a Driver Health Protocol handle\r
    //\r
    Status = GetSingleControllerHealthStatus (DriverHealthList, DriverHealthHandles[DriverHealthIndex], NULL, NULL, DriverHealth, &HealthStatus);\r
\r
    //\r
    // If Status is an error code, then the health information could not be retrieved, so assume healthy\r
    // and skip to the next Driver Health Protocol handle\r
    //\r
    if (EFI_ERROR (Status)) {\r
      continue;\r
    }\r
\r
    //\r
    // If all the controllers managed by this Driver Health Protocol are healthy, then skip to the next\r
    // Driver Health Protocol handle\r
    //\r
    if (HealthStatus == EfiDriverHealthStatusHealthy) {\r
      continue;\r
    }\r
\r
    //\r
    // See if the list of all handles in the handle database has been retrieved\r
    //\r
    //\r
    if (Handles == NULL) {\r
      //\r
      // Retrieve the list of all handles from the handle database\r
      //\r
      Status = gBS->LocateHandleBuffer (\r
        AllHandles,\r
        NULL,\r
        NULL,\r
        &HandleCount,\r
        &Handles\r
        );\r
      if (EFI_ERROR (Status) || Handles == NULL) {\r
        //\r
        // If all the handles in the handle database can not be retrieved, then\r
        // return EFI_OUT_OF_RESOURCES\r
        //\r
        Status = EFI_OUT_OF_RESOURCES;\r
        goto Done;\r
      }\r
    }\r
    //\r
    // Loop through all the controller handles in the handle database\r
    //\r
    for (ControllerIndex = 0; ControllerIndex < HandleCount; ControllerIndex++) {\r
      //\r
      // Skip NULL controller handles\r
      //\r
      if (Handles[ControllerIndex] == NULL) {\r
        continue;\r
      }\r
\r
      Status = GetSingleControllerHealthStatus (DriverHealthList, DriverHealthHandles[DriverHealthIndex], Handles[ControllerIndex], NULL, DriverHealth, &HealthStatus);\r
      if (EFI_ERROR (Status)) {\r
        //\r
        // If Status is an error code, then the health information could not be retrieved, so assume healthy\r
        //\r
        HealthStatus = EfiDriverHealthStatusHealthy;\r
      }\r
\r
      //\r
      // If CheckHealthSingleController() returned an error on a terminal state, then do not check the health of child controllers\r
      //\r
      if (EFI_ERROR (Status)) {\r
        continue;\r
      }\r
\r
      //\r
      // Loop through all the child handles in the handle database\r
      //\r
      for (ChildIndex = 0; ChildIndex < HandleCount; ChildIndex++) {\r
        //\r
        // Skip NULL child handles\r
        //\r
        if (Handles[ChildIndex] == NULL) {\r
          continue;\r
        }\r
\r
        Status = GetSingleControllerHealthStatus (DriverHealthList, DriverHealthHandles[DriverHealthIndex], Handles[ControllerIndex], Handles[ChildIndex], DriverHealth, &HealthStatus);\r
        if (EFI_ERROR (Status)) {\r
          //\r
          // If Status is an error code, then the health information could not be retrieved, so assume healthy\r
          //\r
          HealthStatus = EfiDriverHealthStatusHealthy;\r
        }\r
\r
        //\r
        // If CheckHealthSingleController() returned an error on a terminal state, then skip to the next child\r
        //\r
        if (EFI_ERROR (Status)) {\r
          continue;\r
        }\r
      }\r
    }\r
  }\r
\r
  Status = EFI_SUCCESS;\r
\r
Done:\r
  if (Handles != NULL) {\r
    gBS->FreePool (Handles);\r
  }\r
  if (DriverHealthHandles != NULL) {\r
    gBS->FreePool (DriverHealthHandles);\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Check the healthy status of the platform, this function will return immediately while found one driver\r
  in the platform are not healthy.\r
\r
  @retval FALSE      at least one driver in the platform are not healthy.\r
  @retval TRUE       No controller install Driver Health Protocol,\r
                     or all controllers in the platform are in healthy status.\r
**/\r
BOOLEAN\r
PlaformHealthStatusCheck (\r
  VOID\r
  )\r
{\r
  EFI_DRIVER_HEALTH_STATUS          HealthStatus;\r
  EFI_STATUS                        Status;\r
  UINTN                             Index;\r
  UINTN                             NoHandles;\r
  EFI_HANDLE                        *DriverHealthHandles;\r
  EFI_DRIVER_HEALTH_PROTOCOL        *DriverHealth;\r
  BOOLEAN                           AllHealthy;\r
\r
  //\r
  // Initialize local variables\r
  //\r
  DriverHealthHandles = NULL;\r
  DriverHealth        = NULL;\r
\r
  HealthStatus = EfiDriverHealthStatusHealthy;\r
\r
  Status = gBS->LocateHandleBuffer (\r
                  ByProtocol,\r
                  &gEfiDriverHealthProtocolGuid,\r
                  NULL,\r
                  &NoHandles,\r
                  &DriverHealthHandles\r
                  );\r
  //\r
  // There are no handles match the search for Driver Health Protocol has been installed.\r
  //\r
  if (Status == EFI_NOT_FOUND) {\r
    return TRUE;\r
  }\r
  //\r
  // Assume all modules are healthy.\r
  //\r
  AllHealthy = TRUE;\r
\r
  //\r
  // Found one or more Handles.\r
  //\r
  if (!EFI_ERROR (Status)) {\r
    for (Index = 0; Index < NoHandles; Index++) {\r
      Status = gBS->HandleProtocol (\r
                      DriverHealthHandles[Index],\r
                      &gEfiDriverHealthProtocolGuid,\r
                      (VOID **) &DriverHealth\r
                      );\r
      if (!EFI_ERROR (Status)) {\r
        Status = DriverHealth->GetHealthStatus (\r
                                 DriverHealth,\r
                                 NULL,\r
                                 NULL,\r
                                 &HealthStatus,\r
                                 NULL,\r
                                 NULL\r
                                 );\r
      }\r
      //\r
      // Get the healthy status of the module\r
      //\r
      if (!EFI_ERROR (Status)) {\r
         if (HealthStatus != EfiDriverHealthStatusHealthy) {\r
           //\r
           // Return immediately one driver's status not in healthy.\r
           //\r
           return FALSE;\r
         }\r
      }\r
    }\r
  }\r
  return AllHealthy;\r
}\r
\r
/**\r
  Processes a single controller using the EFI Driver Health Protocol associated with\r
  that controller. This algorithm continues to query the GetHealthStatus() service until\r
  one of the legal terminal states of the EFI Driver Health Protocol is reached. This may\r
  require the processing of HII Messages, HII Form, and invocation of repair operations.\r
\r
  @param DriverHealth       A pointer to the EFI_DRIVER_HEALTH_PROTOCOL instance.\r
  @param ControllerHandle   The class guid specifies which form set will be displayed.\r
  @param ChildHandle        The handle of the child controller to retrieve the health\r
                            status on.  This is an optional parameter that may be NULL.\r
  @param HealthStatus       The health status of the controller.\r
  @param MessageList        An array of warning or error messages associated\r
                            with the controller specified by ControllerHandle and\r
                            ChildHandle.  This is an optional parameter that may be NULL.\r
  @param FormHiiHandle      The HII handle for an HII form associated with the\r
                            controller specified by ControllerHandle and ChildHandle.\r
  @param RebootRequired     Indicate whether a reboot is required to repair the controller.\r
**/\r
VOID\r
ProcessSingleControllerHealth (\r
  IN  EFI_DRIVER_HEALTH_PROTOCOL         *DriverHealth,\r
  IN  EFI_HANDLE                         ControllerHandle, OPTIONAL\r
  IN  EFI_HANDLE                         ChildHandle,      OPTIONAL\r
  IN  EFI_DRIVER_HEALTH_STATUS           HealthStatus,\r
  IN  EFI_DRIVER_HEALTH_HII_MESSAGE      **MessageList,    OPTIONAL\r
  IN  EFI_HII_HANDLE                     FormHiiHandle,\r
  IN OUT BOOLEAN                         *RebootRequired\r
  )\r
{\r
  EFI_STATUS                         Status;\r
  EFI_DRIVER_HEALTH_STATUS           LocalHealthStatus;\r
\r
  LocalHealthStatus = HealthStatus;\r
  //\r
  // If the module need to be repaired or reconfiguration,  will process it until\r
  // reach a terminal status. The status from EfiDriverHealthStatusRepairRequired after repair\r
  // will be in (Health, Failed, Configuration Required).\r
  //\r
  while(LocalHealthStatus == EfiDriverHealthStatusConfigurationRequired ||\r
        LocalHealthStatus == EfiDriverHealthStatusRepairRequired) {\r
\r
    if (LocalHealthStatus == EfiDriverHealthStatusRepairRequired) {\r
      Status = DriverHealth->Repair (\r
                               DriverHealth,\r
                               ControllerHandle,\r
                               ChildHandle,\r
                               RepairNotify\r
                               );\r
    }\r
    //\r
    // Via a form of the driver need to do configuration provided to process of status in\r
    // EfiDriverHealthStatusConfigurationRequired. The status after configuration should be in\r
    // (Healthy, Reboot Required, Failed, Reconnect Required, Repair Required).\r
    //\r
    if (LocalHealthStatus == EfiDriverHealthStatusConfigurationRequired) {\r
      if (FormHiiHandle != NULL) {\r
        Status = gFormBrowser2->SendForm (\r
                                  gFormBrowser2,\r
                                  &FormHiiHandle,\r
                                  1,\r
                                  &gEfiHiiDriverHealthFormsetGuid,\r
                                  0,\r
                                  NULL,\r
                                  NULL\r
                                  );\r
        ASSERT( !EFI_ERROR (Status));\r
      } else {\r
        //\r
        // Exit the loop in case no FormHiiHandle is supplied to prevent dead-loop\r
        //\r
        break;\r
      }\r
    }\r
\r
    Status = DriverHealth->GetHealthStatus (\r
                              DriverHealth,\r
                              ControllerHandle,\r
                              ChildHandle,\r
                              &LocalHealthStatus,\r
                              NULL,\r
                              &FormHiiHandle\r
                              );\r
    ASSERT_EFI_ERROR (Status);\r
\r
    if (*MessageList != NULL) {\r
      ProcessMessages (*MessageList);\r
    }\r
  }\r
\r
  //\r
  // Health status in {Healthy, Failed} may also have Messages need to process\r
  //\r
  if (LocalHealthStatus == EfiDriverHealthStatusHealthy || LocalHealthStatus == EfiDriverHealthStatusFailed) {\r
    if (*MessageList != NULL) {\r
      ProcessMessages (*MessageList);\r
    }\r
  }\r
  //\r
  // Check for RebootRequired or ReconnectRequired\r
  //\r
  if (LocalHealthStatus == EfiDriverHealthStatusRebootRequired) {\r
    *RebootRequired = TRUE;\r
  }\r
\r
  //\r
  // Do reconnect if need.\r
  //\r
  if (LocalHealthStatus == EfiDriverHealthStatusReconnectRequired) {\r
    Status = gBS->DisconnectController (ControllerHandle, NULL, NULL);\r
    if (EFI_ERROR (Status)) {\r
      //\r
      // Disconnect failed.  Need to promote reconnect to a reboot.\r
      //\r
      *RebootRequired = TRUE;\r
    } else {\r
      gBS->ConnectController (ControllerHandle, NULL, NULL, TRUE);\r
    }\r
  }\r
}\r
\r
\r
/**\r
  Reports the progress of a repair operation.\r
\r
  @param[in]  Value             A value between 0 and Limit that identifies the current\r
                                progress of the repair operation.\r
\r
  @param[in]  Limit             The maximum value of Value for the current repair operation.\r
                                For example, a driver that wants to specify progress in\r
                                percent would use a Limit value of 100.\r
\r
  @retval EFI_SUCCESS           The progress of a repair operation is reported successfully.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
RepairNotify (\r
  IN  UINTN Value,\r
  IN  UINTN Limit\r
  )\r
{\r
  UINTN Percent;\r
\r
  if (Limit  == 0) {\r
    Print(L"Repair Progress Undefined\n\r");\r
  } else {\r
    Percent = Value * 100 / Limit;\r
    Print(L"Repair Progress = %3d%%\n\r", Percent);\r
  }\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Processes a set of messages returned by the GetHealthStatus ()\r
  service of the EFI Driver Health Protocol\r
\r
  @param    MessageList  The MessageList point to messages need to processed.\r
\r
**/\r
VOID\r
ProcessMessages (\r
  IN  EFI_DRIVER_HEALTH_HII_MESSAGE      *MessageList\r
  )\r
{\r
  UINTN                           MessageIndex;\r
  EFI_STRING                      MessageString;\r
\r
  for (MessageIndex = 0;\r
       MessageList[MessageIndex].HiiHandle != NULL;\r
       MessageIndex++) {\r
\r
    MessageString = HiiGetString (\r
                        MessageList[MessageIndex].HiiHandle,\r
                        MessageList[MessageIndex].StringId,\r
                        NULL\r
                        );\r
    if (MessageString != NULL) {\r
      //\r
      // User can customize the output. Just simply print out the MessageString like below.\r
      // Also can use the HiiHandle to display message on the front page.\r
      //\r
      // Print(L"%s\n",MessageString);\r
      // gBS->Stall (100000);\r
    }\r
  }\r
\r
}\r
\r
/**\r
  Repair the whole platform.\r
\r
  This function is the main entry for user choose "Repair All" in the front page.\r
  It will try to do recovery job till all the driver health protocol installed modules\r
  reach a terminal state.\r
\r
  @param DriverHealthList   A Pointer to the list contain all of the platform driver health\r
                            information.\r
\r
**/\r
VOID\r
PlatformRepairAll (\r
  IN LIST_ENTRY  *DriverHealthList\r
  )\r
{\r
  DRIVER_HEALTH_INFO          *DriverHealthInfo;\r
  LIST_ENTRY                  *Link;\r
  BOOLEAN                     RebootRequired;\r
\r
  ASSERT (DriverHealthList != NULL);\r
\r
  RebootRequired = FALSE;\r
\r
  for ( Link = GetFirstNode (DriverHealthList)\r
      ; !IsNull (DriverHealthList, Link)\r
      ; Link = GetNextNode (DriverHealthList, Link)\r
      ) {\r
    DriverHealthInfo = DEVICE_MANAGER_HEALTH_INFO_FROM_LINK (Link);\r
    //\r
    // Do driver health status operation by each link node\r
    //\r
    ASSERT (DriverHealthInfo != NULL);\r
\r
    ProcessSingleControllerHealth (\r
      DriverHealthInfo->DriverHealth,\r
      DriverHealthInfo->ControllerHandle,\r
      DriverHealthInfo->ChildHandle,\r
      DriverHealthInfo->HealthStatus,\r
      &(DriverHealthInfo->MessageList),\r
      DriverHealthInfo->HiiHandle,\r
      &RebootRequired\r
      );\r
  }\r
\r
  if (RebootRequired) {\r
    gRT->ResetSystem (EfiResetWarm, EFI_SUCCESS, 0, NULL);\r
  }\r
}\r
\r
/**\r
\r
  Select the best matching language according to front page policy for best user experience.\r
\r
  This function supports both ISO 639-2 and RFC 4646 language codes, but language\r
  code types may not be mixed in a single call to this function.\r
\r
  @param  SupportedLanguages   A pointer to a Null-terminated ASCII string that\r
                               contains a set of language codes in the format\r
                               specified by Iso639Language.\r
  @param  Iso639Language       If TRUE, then all language codes are assumed to be\r
                               in ISO 639-2 format.  If FALSE, then all language\r
                               codes are assumed to be in RFC 4646 language format.\r
\r
  @retval NULL                 The best matching language could not be found in SupportedLanguages.\r
  @retval NULL                 There are not enough resources available to return the best matching\r
                               language.\r
  @retval Other                A pointer to a Null-terminated ASCII string that is the best matching\r
                               language in SupportedLanguages.\r
**/\r
CHAR8 *\r
DriverHealthSelectBestLanguage (\r
  IN CHAR8        *SupportedLanguages,\r
  IN BOOLEAN      Iso639Language\r
  )\r
{\r
  CHAR8           *LanguageVariable;\r
  CHAR8           *BestLanguage;\r
\r
  GetEfiGlobalVariable2 (Iso639Language ? L"Lang" : L"PlatformLang", (VOID**)&LanguageVariable, NULL);\r
\r
  BestLanguage = GetBestLanguage(\r
                   SupportedLanguages,\r
                   Iso639Language,\r
                   (LanguageVariable != NULL) ? LanguageVariable : "",\r
                   Iso639Language ? "eng" : "en-US",\r
                   NULL\r
                   );\r
  if (LanguageVariable != NULL) {\r
    FreePool (LanguageVariable);\r
  }\r
\r
  return BestLanguage;\r
}\r
\r
\r
\r
/**\r
\r
  This is an internal worker function to get the Component Name (2) protocol interface\r
  and the language it supports.\r
\r
  @param  ProtocolGuid         A pointer to an EFI_GUID. It points to Component Name (2) protocol GUID.\r
  @param  DriverBindingHandle  The handle on which the Component Name (2) protocol instance is retrieved.\r
  @param  ComponentName        A pointer to the Component Name (2) protocol interface.\r
  @param  SupportedLanguage    The best suitable language that matches the SupportedLangues interface for the\r
                               located Component Name (2) instance.\r
\r
  @retval EFI_SUCCESS          The Component Name (2) protocol instance is successfully located and we find\r
                               the best matching language it support.\r
  @retval EFI_UNSUPPORTED      The input Language is not supported by the Component Name (2) protocol.\r
  @retval Other                Some error occurs when locating Component Name (2) protocol instance or finding\r
                               the supported language.\r
\r
**/\r
EFI_STATUS\r
GetComponentNameWorker (\r
  IN  EFI_GUID                    *ProtocolGuid,\r
  IN  EFI_HANDLE                  DriverBindingHandle,\r
  OUT EFI_COMPONENT_NAME_PROTOCOL **ComponentName,\r
  OUT CHAR8                       **SupportedLanguage\r
  )\r
{\r
  EFI_STATUS                      Status;\r
\r
  //\r
  // Locate Component Name (2) protocol on the driver binging handle.\r
  //\r
  Status = gBS->OpenProtocol (\r
                 DriverBindingHandle,\r
                 ProtocolGuid,\r
                 (VOID **) ComponentName,\r
                 NULL,\r
                 NULL,\r
                 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
                 );\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Apply shell policy to select the best language.\r
  //\r
  *SupportedLanguage = DriverHealthSelectBestLanguage (\r
                         (*ComponentName)->SupportedLanguages,\r
                         (BOOLEAN) (ProtocolGuid == &gEfiComponentNameProtocolGuid)\r
                         );\r
  if (*SupportedLanguage == NULL) {\r
    Status = EFI_UNSUPPORTED;\r
  }\r
\r
  return Status;\r
}\r
\r
/**\r
\r
  This is an internal worker function to get driver name from Component Name (2) protocol interface.\r
\r
\r
  @param  ProtocolGuid         A pointer to an EFI_GUID. It points to Component Name (2) protocol GUID.\r
  @param  DriverBindingHandle  The handle on which the Component Name (2) protocol instance is retrieved.\r
  @param  DriverName           A pointer to the Unicode string to return. This Unicode string is the name\r
                               of the driver specified by This.\r
\r
  @retval EFI_SUCCESS          The driver name is successfully retrieved from Component Name (2) protocol\r
                               interface.\r
  @retval Other                The driver name cannot be retrieved from Component Name (2) protocol\r
                               interface.\r
\r
**/\r
EFI_STATUS\r
GetDriverNameWorker (\r
  IN  EFI_GUID    *ProtocolGuid,\r
  IN  EFI_HANDLE  DriverBindingHandle,\r
  OUT CHAR16      **DriverName\r
  )\r
{\r
  EFI_STATUS                     Status;\r
  CHAR8                          *BestLanguage;\r
  EFI_COMPONENT_NAME_PROTOCOL    *ComponentName;\r
\r
  //\r
  // Retrieve Component Name (2) protocol instance on the driver binding handle and\r
  // find the best language this instance supports.\r
  //\r
  Status = GetComponentNameWorker (\r
             ProtocolGuid,\r
             DriverBindingHandle,\r
             &ComponentName,\r
             &BestLanguage\r
             );\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Get the driver name from Component Name (2) protocol instance on the driver binging handle.\r
  //\r
  Status = ComponentName->GetDriverName (\r
                            ComponentName,\r
                            BestLanguage,\r
                            DriverName\r
                            );\r
  FreePool (BestLanguage);\r
\r
  return Status;\r
}\r
\r
/**\r
\r
  This function gets driver name from Component Name 2 protocol interface and Component Name protocol interface\r
  in turn. It first tries UEFI 2.0 Component Name 2 protocol interface and try to get the driver name.\r
  If the attempt fails, it then gets the driver name from EFI 1.1 Component Name protocol for backward\r
  compatibility support.\r
\r
  @param  DriverBindingHandle  The handle on which the Component Name (2) protocol instance is retrieved.\r
  @param  DriverName           A pointer to the Unicode string to return. This Unicode string is the name\r
                               of the driver specified by This.\r
\r
  @retval EFI_SUCCESS          The driver name is successfully retrieved from Component Name (2) protocol\r
                               interface.\r
  @retval Other                The driver name cannot be retrieved from Component Name (2) protocol\r
                               interface.\r
\r
**/\r
EFI_STATUS\r
DriverHealthGetDriverName (\r
  IN  EFI_HANDLE  DriverBindingHandle,\r
  OUT CHAR16      **DriverName\r
  )\r
{\r
  EFI_STATUS      Status;\r
\r
  //\r
  // Get driver name from UEFI 2.0 Component Name 2 protocol interface.\r
  //\r
  Status = GetDriverNameWorker (&gEfiComponentName2ProtocolGuid, DriverBindingHandle, DriverName);\r
  if (EFI_ERROR (Status)) {\r
    //\r
    // If it fails to get the driver name from Component Name protocol interface, we should fall back on\r
    // EFI 1.1 Component Name protocol interface.\r
    //\r
    Status = GetDriverNameWorker (&gEfiComponentNameProtocolGuid, DriverBindingHandle, DriverName);\r
  }\r
\r
  return Status;\r
}\r
\r
\r
\r
/**\r
  This function gets controller name from Component Name 2 protocol interface and Component Name protocol interface\r
  in turn. It first tries UEFI 2.0 Component Name 2 protocol interface and try to get the controller name.\r
  If the attempt fails, it then gets the controller name from EFI 1.1 Component Name protocol for backward\r
  compatibility support.\r
\r
  @param  ProtocolGuid         A pointer to an EFI_GUID. It points to Component Name (2) protocol GUID.\r
  @param  DriverBindingHandle  The handle on which the Component Name (2) protocol instance is retrieved.\r
  @param  ControllerHandle     The handle of a controller that the driver specified by This is managing.\r
                               This handle specifies the controller whose name is to be returned.\r
  @param  ChildHandle          The handle of the child controller to retrieve the name of. This is an\r
                               optional parameter that may be NULL. It will be NULL for device drivers.\r
                               It will also be NULL for bus drivers that attempt to retrieve the name\r
                               of the bus controller. It will not be NULL for a bus driver that attempts\r
                               to retrieve the name of a child controller.\r
  @param  ControllerName       A pointer to the Unicode string to return. This Unicode string\r
                               is the name of the controller specified by ControllerHandle and ChildHandle.\r
\r
  @retval  EFI_SUCCESS         The controller name is successfully retrieved from Component Name (2) protocol\r
                               interface.\r
  @retval  Other               The controller name cannot be retrieved from Component Name (2) protocol.\r
\r
**/\r
EFI_STATUS\r
GetControllerNameWorker (\r
  IN  EFI_GUID    *ProtocolGuid,\r
  IN  EFI_HANDLE  DriverBindingHandle,\r
  IN  EFI_HANDLE  ControllerHandle,\r
  IN  EFI_HANDLE  ChildHandle,\r
  OUT CHAR16      **ControllerName\r
  )\r
{\r
  EFI_STATUS                     Status;\r
  CHAR8                          *BestLanguage;\r
  EFI_COMPONENT_NAME_PROTOCOL    *ComponentName;\r
\r
  //\r
  // Retrieve Component Name (2) protocol instance on the driver binding handle and\r
  // find the best language this instance supports.\r
  //\r
  Status = GetComponentNameWorker (\r
             ProtocolGuid,\r
             DriverBindingHandle,\r
             &ComponentName,\r
             &BestLanguage\r
             );\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Get the controller name from Component Name (2) protocol instance on the driver binging handle.\r
  //\r
  Status = ComponentName->GetControllerName (\r
                            ComponentName,\r
                            ControllerHandle,\r
                            ChildHandle,\r
                            BestLanguage,\r
                            ControllerName\r
                            );\r
  FreePool (BestLanguage);\r
\r
  return Status;\r
}\r
\r
/**\r
\r
  This function gets controller name from Component Name 2 protocol interface and Component Name protocol interface\r
  in turn. It first tries UEFI 2.0 Component Name 2 protocol interface and try to get the controller name.\r
  If the attempt fails, it then gets the controller name from EFI 1.1 Component Name protocol for backward\r
  compatibility support.\r
\r
  @param  DriverBindingHandle  The handle on which the Component Name (2) protocol instance is retrieved.\r
  @param  ControllerHandle     The handle of a controller that the driver specified by This is managing.\r
                               This handle specifies the controller whose name is to be returned.\r
  @param  ChildHandle          The handle of the child controller to retrieve the name of. This is an\r
                               optional parameter that may be NULL. It will be NULL for device drivers.\r
                               It will also be NULL for bus drivers that attempt to retrieve the name\r
                               of the bus controller. It will not be NULL for a bus driver that attempts\r
                               to retrieve the name of a child controller.\r
  @param  ControllerName       A pointer to the Unicode string to return. This Unicode string\r
                               is the name of the controller specified by ControllerHandle and ChildHandle.\r
\r
  @retval EFI_SUCCESS          The controller name is successfully retrieved from Component Name (2) protocol\r
                               interface.\r
  @retval Other                The controller name cannot be retrieved from Component Name (2) protocol.\r
\r
**/\r
EFI_STATUS\r
DriverHealthGetControllerName (\r
  IN  EFI_HANDLE  DriverBindingHandle,\r
  IN  EFI_HANDLE  ControllerHandle,\r
  IN  EFI_HANDLE  ChildHandle,\r
  OUT CHAR16      **ControllerName\r
  )\r
{\r
  EFI_STATUS      Status;\r
\r
  //\r
  // Get controller name from UEFI 2.0 Component Name 2 protocol interface.\r
  //\r
  Status = GetControllerNameWorker (\r
             &gEfiComponentName2ProtocolGuid,\r
             DriverBindingHandle,\r
             ControllerHandle,\r
             ChildHandle,\r
             ControllerName\r
             );\r
  if (EFI_ERROR (Status)) {\r
    //\r
    // If it fails to get the controller name from Component Name protocol interface, we should fall back on\r
    // EFI 1.1 Component Name protocol interface.\r
    //\r
    Status = GetControllerNameWorker (\r
               &gEfiComponentNameProtocolGuid,\r
               DriverBindingHandle,\r
               ControllerHandle,\r
               ChildHandle,\r
               ControllerName\r
               );\r
  }\r
\r
  return Status;\r
}\r