IntelFsp2WrapperPkg: Apply uncrustify changes

[mirror_edk2.git] / MdeModulePkg / Universal / Acpi / BootGraphicsResourceTableDxe / BootGraphicsResourceTableDxe.c

/** @file\r
  This module install ACPI Boot Graphics Resource Table (BGRT).\r
\r
  Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>\r
  Copyright (c) 2016, Microsoft Corporation<BR>\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
**/\r
\r
#include <Uefi.h>\r
\r
#include <IndustryStandard/Acpi.h>\r
\r
#include <Protocol/AcpiTable.h>\r
#include <Protocol/GraphicsOutput.h>\r
#include <Protocol/BootLogo.h>\r
#include <Protocol/BootLogo2.h>\r
\r
#include <Guid/EventGroup.h>\r
\r
#include <Library/BaseLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/MemoryAllocationLib.h>\r
#include <Library/UefiBootServicesTableLib.h>\r
#include <Library/DebugLib.h>\r
#include <Library/PcdLib.h>\r
#include <Library/SafeIntLib.h>\r
#include <Library/BmpSupportLib.h>\r
\r
/**\r
  Update information of logo image drawn on screen.\r
\r
  @param[in] This          The pointer to the Boot Logo protocol 2 instance.\r
  @param[in] BltBuffer     The BLT buffer for logo drawn on screen. If BltBuffer\r
                           is set to NULL, it indicates that logo image is no\r
                           longer on the screen.\r
  @param[in] DestinationX  X coordinate of destination for the BltBuffer.\r
  @param[in] DestinationY  Y coordinate of destination for the BltBuffer.\r
  @param[in] Width         Width of rectangle in BltBuffer in pixels.\r
  @param[in] Height        Hight of rectangle in BltBuffer in pixels.\r
\r
  @retval EFI_SUCCESS            The boot logo information was updated.\r
  @retval EFI_INVALID_PARAMETER  One of the parameters has an invalid value.\r
  @retval EFI_OUT_OF_RESOURCES   The logo information was not updated due to\r
                                 insufficient memory resources.\r
**/\r
EFI_STATUS\r
EFIAPI\r
SetBootLogo (\r
  IN EFI_BOOT_LOGO_PROTOCOL         *This,\r
  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL  *BltBuffer       OPTIONAL,\r
  IN UINTN                          DestinationX,\r
  IN UINTN                          DestinationY,\r
  IN UINTN                          Width,\r
  IN UINTN                          Height\r
  );\r
\r
/**\r
  Update information of logo image drawn on screen.\r
\r
  @param[in] This          The pointer to the Boot Logo protocol 2 instance.\r
  @param[in] BltBuffer     The BLT buffer for logo drawn on screen. If BltBuffer\r
                           is set to NULL, it indicates that logo image is no\r
                           longer on the screen.\r
  @param[in] DestinationX  X coordinate of destination for the BltBuffer.\r
  @param[in] DestinationY  Y coordinate of destination for the BltBuffer.\r
  @param[in] Width         Width of rectangle in BltBuffer in pixels.\r
  @param[in] Height        Hight of rectangle in BltBuffer in pixels.\r
\r
  @retval EFI_SUCCESS            The boot logo information was updated.\r
  @retval EFI_INVALID_PARAMETER  One of the parameters has an invalid value.\r
  @retval EFI_OUT_OF_RESOURCES   The logo information was not updated due to\r
                                 insufficient memory resources.\r
**/\r
EFI_STATUS\r
EFIAPI\r
SetBootLogo2 (\r
  IN EDKII_BOOT_LOGO2_PROTOCOL      *This,\r
  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL  *BltBuffer       OPTIONAL,\r
  IN UINTN                          DestinationX,\r
  IN UINTN                          DestinationY,\r
  IN UINTN                          Width,\r
  IN UINTN                          Height\r
  );\r
\r
/**\r
  Get the location of the boot logo on the screen.\r
\r
  @param[in]  This          The pointer to the Boot Logo Protocol 2 instance\r
  @param[out] BltBuffer     Returns pointer to the GOP BLT buffer that was\r
                            previously registered with SetBootLogo2(). The\r
                            buffer returned must not be modified or freed.\r
  @param[out] DestinationX  Returns the X start position of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
  @param[out] DestinationY  Returns the Y start position of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
  @param[out] Width         Returns the width of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
  @param[out] Height        Returns the height of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
\r
  @retval EFI_SUCCESS            The location of the boot logo was returned.\r
  @retval EFI_NOT_READY          The boot logo has not been set.\r
  @retval EFI_INVALID_PARAMETER  BltBuffer is NULL.\r
  @retval EFI_INVALID_PARAMETER  DestinationX is NULL.\r
  @retval EFI_INVALID_PARAMETER  DestinationY is NULL.\r
  @retval EFI_INVALID_PARAMETER  Width is NULL.\r
  @retval EFI_INVALID_PARAMETER  Height is NULL.\r
**/\r
EFI_STATUS\r
EFIAPI\r
GetBootLogo2 (\r
  IN  EDKII_BOOT_LOGO2_PROTOCOL      *This,\r
  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL  **BltBuffer,\r
  OUT UINTN                          *DestinationX,\r
  OUT UINTN                          *DestinationY,\r
  OUT UINTN                          *Width,\r
  OUT UINTN                          *Height\r
  );\r
\r
//\r
// Boot Logo Protocol Handle\r
//\r
EFI_HANDLE  mBootLogoHandle = NULL;\r
\r
//\r
// Boot Logo Protocol Instance\r
//\r
EFI_BOOT_LOGO_PROTOCOL  mBootLogoProtocolTemplate = {\r
  SetBootLogo\r
};\r
\r
///\r
/// Boot Logo 2 Protocol instance\r
///\r
EDKII_BOOT_LOGO2_PROTOCOL mBootLogo2ProtocolTemplate = {\r
  SetBootLogo2,\r
  GetBootLogo2\r
};\r
\r
EFI_EVENT                      mBootGraphicsReadyToBootEvent;\r
UINTN                          mBootGraphicsResourceTableKey = 0;\r
BOOLEAN                        mIsLogoValid = FALSE;\r
EFI_GRAPHICS_OUTPUT_BLT_PIXEL  *mLogoBltBuffer = NULL;\r
UINTN                          mLogoDestX  = 0;\r
UINTN                          mLogoDestY  = 0;\r
UINTN                          mLogoWidth  = 0;\r
UINTN                          mLogoHeight = 0;\r
BOOLEAN                        mAcpiBgrtInstalled     = FALSE;\r
BOOLEAN                        mAcpiBgrtStatusChanged = FALSE;\r
BOOLEAN                        mAcpiBgrtBufferChanged = FALSE;\r
\r
//\r
// ACPI Boot Graphics Resource Table template\r
//\r
EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE mBootGraphicsResourceTableTemplate = {\r
  {\r
    EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE,\r
    sizeof (EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE),\r
    EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION,     // Revision\r
    0x00,  // Checksum will be updated at runtime\r
    //\r
    // It is expected that these values will be updated at EntryPoint.\r
    //\r
    {0x00},     // OEM ID is a 6 bytes long field\r
    0x00,       // OEM Table ID(8 bytes long)\r
    0x00,       // OEM Revision\r
    0x00,       // Creator ID\r
    0x00,       // Creator Revision\r
  },\r
  EFI_ACPI_5_0_BGRT_VERSION,         // Version\r
  EFI_ACPI_5_0_BGRT_STATUS_VALID,    // Status\r
  EFI_ACPI_5_0_BGRT_IMAGE_TYPE_BMP,  // Image Type\r
  0,                                 // Image Address\r
  0,                                 // Image Offset X\r
  0                                  // Image Offset Y\r
};\r
\r
/**\r
  Update information of logo image drawn on screen.\r
\r
  @param  This           The pointer to the Boot Logo protocol instance.\r
  @param  BltBuffer      The BLT buffer for logo drawn on screen. If BltBuffer\r
                         is set to NULL, it indicates that logo image is no\r
                         longer on the screen.\r
  @param  DestinationX   X coordinate of destination for the BltBuffer.\r
  @param  DestinationY   Y coordinate of destination for the BltBuffer.\r
  @param  Width          Width of rectangle in BltBuffer in pixels.\r
  @param  Height         Hight of rectangle in BltBuffer in pixels.\r
\r
  @retval EFI_SUCCESS             The boot logo information was updated.\r
  @retval EFI_INVALID_PARAMETER   One of the parameters has an invalid value.\r
  @retval EFI_OUT_OF_RESOURCES    The logo information was not updated due to\r
                                  insufficient memory resources.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SetBootLogo (\r
  IN EFI_BOOT_LOGO_PROTOCOL            *This,\r
  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL     *BltBuffer       OPTIONAL,\r
  IN UINTN                             DestinationX,\r
  IN UINTN                             DestinationY,\r
  IN UINTN                             Width,\r
  IN UINTN                             Height\r
  )\r
{\r
  //\r
  // Call same service in Boot Logo 2 Protocol\r
  //\r
  return SetBootLogo2 (\r
           &mBootLogo2ProtocolTemplate,\r
           BltBuffer,\r
           DestinationX,\r
           DestinationY,\r
           Width,\r
           Height\r
           );\r
}\r
\r
/**\r
  Update information of logo image drawn on screen.\r
\r
  @param[in] This          The pointer to the Boot Logo protocol 2 instance.\r
  @param[in] BltBuffer     The BLT buffer for logo drawn on screen. If BltBuffer\r
                           is set to NULL, it indicates that logo image is no\r
                           longer on the screen.\r
  @param[in] DestinationX  X coordinate of destination for the BltBuffer.\r
  @param[in] DestinationY  Y coordinate of destination for the BltBuffer.\r
  @param[in] Width         Width of rectangle in BltBuffer in pixels.\r
  @param[in] Height        Hight of rectangle in BltBuffer in pixels.\r
\r
  @retval EFI_SUCCESS            The boot logo information was updated.\r
  @retval EFI_INVALID_PARAMETER  One of the parameters has an invalid value.\r
  @retval EFI_OUT_OF_RESOURCES   The logo information was not updated due to\r
                                 insufficient memory resources.\r
**/\r
EFI_STATUS\r
EFIAPI\r
SetBootLogo2 (\r
  IN EDKII_BOOT_LOGO2_PROTOCOL      *This,\r
  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL  *BltBuffer       OPTIONAL,\r
  IN UINTN                          DestinationX,\r
  IN UINTN                          DestinationY,\r
  IN UINTN                          Width,\r
  IN UINTN                          Height\r
  )\r
{\r
  EFI_STATUS  Status;\r
  UINTN       BufferSize;\r
  UINT32      Result32;\r
\r
  if (BltBuffer == NULL) {\r
    mIsLogoValid = FALSE;\r
    mAcpiBgrtStatusChanged = TRUE;\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // Width and height are not allowed to be zero.\r
  //\r
  if (Width == 0 || Height == 0) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Verify destination, width, and height do not overflow 32-bit values.\r
  // The Boot Graphics Resource Table only has 32-bit fields for these values.\r
  //\r
  Status = SafeUintnToUint32 (DestinationX, &Result32);\r
  if (EFI_ERROR (Status)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
  Status = SafeUintnToUint32 (DestinationY, &Result32);\r
  if (EFI_ERROR (Status)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
  Status = SafeUintnToUint32 (Width, &Result32);\r
  if (EFI_ERROR (Status)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
  Status = SafeUintnToUint32 (Height, &Result32);\r
  if (EFI_ERROR (Status)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Ensure the Height * Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) does\r
  // not overflow UINTN\r
  //\r
  Status = SafeUintnMult (\r
             Width,\r
             Height,\r
             &BufferSize\r
             );\r
  if (EFI_ERROR (Status)) {\r
    return EFI_UNSUPPORTED;\r
  }\r
  Status = SafeUintnMult (\r
             BufferSize,\r
             sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL),\r
             &BufferSize\r
             );\r
  if (EFI_ERROR (Status)) {\r
    return EFI_UNSUPPORTED;\r
  }\r
\r
  //\r
  // Update state\r
  //\r
  mAcpiBgrtBufferChanged = TRUE;\r
\r
  //\r
  // Free old logo buffer\r
  //\r
  if (mLogoBltBuffer != NULL) {\r
    FreePool (mLogoBltBuffer);\r
    mLogoBltBuffer = NULL;\r
  }\r
\r
  //\r
  // Allocate new logo buffer\r
  //\r
  mLogoBltBuffer = AllocateCopyPool (BufferSize, BltBuffer);\r
  if (mLogoBltBuffer == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  mLogoDestX   = DestinationX;\r
  mLogoDestY   = DestinationY;\r
  mLogoWidth   = Width;\r
  mLogoHeight  = Height;\r
  mIsLogoValid = TRUE;\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Get the location of the boot logo on the screen.\r
\r
  @param[in]  This          The pointer to the Boot Logo Protocol 2 instance\r
  @param[out] BltBuffer     Returns pointer to the GOP BLT buffer that was\r
                            previously registered with SetBootLogo2(). The\r
                            buffer returned must not be modified or freed.\r
  @param[out] DestinationX  Returns the X start position of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
  @param[out] DestinationY  Returns the Y start position of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
  @param[out] Width         Returns the width of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
  @param[out] Height        Returns the height of the GOP BLT buffer\r
                            that was previously registered with SetBootLogo2().\r
\r
  @retval EFI_SUCCESS            The location of the boot logo was returned.\r
  @retval EFI_NOT_READY          The boot logo has not been set.\r
  @retval EFI_INVALID_PARAMETER  BltBuffer is NULL.\r
  @retval EFI_INVALID_PARAMETER  DestinationX is NULL.\r
  @retval EFI_INVALID_PARAMETER  DestinationY is NULL.\r
  @retval EFI_INVALID_PARAMETER  Width is NULL.\r
  @retval EFI_INVALID_PARAMETER  Height is NULL.\r
**/\r
EFI_STATUS\r
EFIAPI\r
GetBootLogo2 (\r
  IN  EDKII_BOOT_LOGO2_PROTOCOL      *This,\r
  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL  **BltBuffer,\r
  OUT UINTN                          *DestinationX,\r
  OUT UINTN                          *DestinationY,\r
  OUT UINTN                          *Width,\r
  OUT UINTN                          *Height\r
  )\r
{\r
  //\r
  // If the boot logo has not been set with SetBootLogo() or SetBootLogo() was\r
  // called with a NULL BltBuffer then the boot logo is not valid and\r
  // EFI_NOT_READY is returned.\r
  //\r
  if (mLogoBltBuffer == NULL) {\r
    DEBUG ((DEBUG_ERROR, "Request to get boot logo location before boot logo has been set.\n"));\r
    return EFI_NOT_READY;\r
  }\r
\r
  //\r
  // Make sure none of the boot logo location parameters are NULL.\r
  //\r
  if (BltBuffer == NULL || DestinationX == NULL || DestinationY == NULL ||\r
      Width == NULL || Height == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Boot logo is valid.  Return values from module globals.\r
  //\r
  *BltBuffer    = mLogoBltBuffer;\r
  *DestinationX = mLogoDestX;\r
  *DestinationY = mLogoDestY;\r
  *Width        = mLogoWidth;\r
  *Height       = mLogoHeight;\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Notify function for event group EFI_EVENT_GROUP_READY_TO_BOOT. This is used to\r
  install the Boot Graphics Resource Table.\r
\r
  @param[in]  Event   The Event that is being processed.\r
  @param[in]  Context The Event Context.\r
\r
**/\r
VOID\r
EFIAPI\r
BgrtReadyToBootEventNotify (\r
  IN EFI_EVENT  Event,\r
  IN VOID       *Context\r
  )\r
{\r
  EFI_STATUS               Status;\r
  EFI_ACPI_TABLE_PROTOCOL  *AcpiTableProtocol;\r
  VOID                     *ImageBuffer;\r
  UINT32                   BmpSize;\r
\r
  //\r
  // Get ACPI Table protocol.\r
  //\r
  Status = gBS->LocateProtocol (\r
                  &gEfiAcpiTableProtocolGuid,\r
                  NULL,\r
                  (VOID **) &AcpiTableProtocol\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    return;\r
  }\r
\r
  //\r
  // Check whether Boot Graphics Resource Table is already installed.\r
  //\r
  if (mAcpiBgrtInstalled) {\r
    if (!mAcpiBgrtStatusChanged && !mAcpiBgrtBufferChanged) {\r
      //\r
      // Nothing has changed\r
      //\r
      return;\r
    } else {\r
      //\r
      // If BGRT data change happens, then uninstall orignal AcpiTable first\r
      //\r
      Status = AcpiTableProtocol->UninstallAcpiTable (\r
                                    AcpiTableProtocol,\r
                                    mBootGraphicsResourceTableKey\r
                                    );\r
      if (EFI_ERROR (Status)) {\r
        return;\r
      }\r
    }\r
  } else {\r
    //\r
    // Check whether Logo exists\r
    //\r
    if (mLogoBltBuffer == NULL) {\r
      return;\r
    }\r
  }\r
\r
  if (mAcpiBgrtBufferChanged) {\r
    //\r
    // Free the old BMP image buffer\r
    //\r
    ImageBuffer = (UINT8 *)(UINTN)mBootGraphicsResourceTableTemplate.ImageAddress;\r
    if (ImageBuffer != NULL) {\r
      FreePool (ImageBuffer);\r
    }\r
\r
    //\r
    // Convert GOP Blt buffer to BMP image.  Pass in ImageBuffer set to NULL\r
    // so the BMP image is allocated by TranslateGopBltToBmp().\r
    //\r
    ImageBuffer = NULL;\r
    Status = TranslateGopBltToBmp (\r
               mLogoBltBuffer,\r
               (UINT32)mLogoHeight,\r
               (UINT32)mLogoWidth,\r
               &ImageBuffer,\r
               &BmpSize\r
               );\r
    if (EFI_ERROR (Status)) {\r
      return;\r
    }\r
\r
    //\r
    // Free the logo buffer\r
    //\r
    FreePool (mLogoBltBuffer);\r
    mLogoBltBuffer = NULL;\r
\r
    //\r
    // Update BMP image fields of the Boot Graphics Resource Table\r
    //\r
    mBootGraphicsResourceTableTemplate.ImageAddress = (UINT64)(UINTN)ImageBuffer;\r
    mBootGraphicsResourceTableTemplate.ImageOffsetX = (UINT32)mLogoDestX;\r
    mBootGraphicsResourceTableTemplate.ImageOffsetY = (UINT32)mLogoDestY;\r
  }\r
\r
  //\r
  // Update Status field of Boot Graphics Resource Table\r
  //\r
  if (mIsLogoValid) {\r
    mBootGraphicsResourceTableTemplate.Status = EFI_ACPI_5_0_BGRT_STATUS_VALID;\r
  } else {\r
    mBootGraphicsResourceTableTemplate.Status = EFI_ACPI_5_0_BGRT_STATUS_INVALID;\r
  }\r
\r
  //\r
  // Update Checksum of Boot Graphics Resource Table\r
  //\r
  mBootGraphicsResourceTableTemplate.Header.Checksum = 0;\r
  mBootGraphicsResourceTableTemplate.Header.Checksum =\r
    CalculateCheckSum8 (\r
      (UINT8 *)&mBootGraphicsResourceTableTemplate,\r
      sizeof (EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE)\r
      );\r
\r
  //\r
  // Publish Boot Graphics Resource Table.\r
  //\r
  Status = AcpiTableProtocol->InstallAcpiTable (\r
                                AcpiTableProtocol,\r
                                &mBootGraphicsResourceTableTemplate,\r
                                sizeof (EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE),\r
                                &mBootGraphicsResourceTableKey\r
                                );\r
  if (EFI_ERROR (Status)) {\r
    return;\r
  }\r
\r
  mAcpiBgrtInstalled     = TRUE;\r
  mAcpiBgrtStatusChanged = FALSE;\r
  mAcpiBgrtBufferChanged = FALSE;\r
}\r
\r
/**\r
  The module Entry Point of the Boot Graphics Resource Table DXE driver.\r
\r
  @param[in]  ImageHandle    The firmware allocated handle for the EFI image.\r
  @param[in]  SystemTable    A pointer to the EFI System Table.\r
\r
  @retval EFI_SUCCESS    The entry point is executed successfully.\r
  @retval Other          Some error occurs when executing this entry point.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BootGraphicsDxeEntryPoint (\r
  IN EFI_HANDLE        ImageHandle,\r
  IN EFI_SYSTEM_TABLE  *SystemTable\r
  )\r
{\r
  EFI_STATUS                   Status;\r
  EFI_ACPI_DESCRIPTION_HEADER  *Header;\r
\r
  //\r
  // Update Header fields of Boot Graphics Resource Table from PCDs\r
  //\r
  Header = &mBootGraphicsResourceTableTemplate.Header;\r
  ZeroMem (Header->OemId, sizeof (Header->OemId));\r
  CopyMem (\r
    Header->OemId,\r
    PcdGetPtr (PcdAcpiDefaultOemId),\r
    MIN (PcdGetSize (PcdAcpiDefaultOemId), sizeof (Header->OemId))\r
    );\r
  WriteUnaligned64 (&Header->OemTableId, PcdGet64 (PcdAcpiDefaultOemTableId));\r
  Header->OemRevision     = PcdGet32 (PcdAcpiDefaultOemRevision);\r
  Header->CreatorId       = PcdGet32 (PcdAcpiDefaultCreatorId);\r
  Header->CreatorRevision = PcdGet32 (PcdAcpiDefaultCreatorRevision);\r
\r
  //\r
  // Install Boot Logo and Boot Logo 2 Protocols.\r
  //\r
  Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &mBootLogoHandle,\r
                  &gEfiBootLogoProtocolGuid,\r
                  &mBootLogoProtocolTemplate,\r
                  &gEdkiiBootLogo2ProtocolGuid,\r
                  &mBootLogo2ProtocolTemplate,\r
                  NULL\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Register notify function to install BGRT on ReadyToBoot Event.\r
  //\r
  Status = gBS->CreateEventEx (\r
                  EVT_NOTIFY_SIGNAL,\r
                  TPL_CALLBACK,\r
                  BgrtReadyToBootEventNotify,\r
                  NULL,\r
                  &gEfiEventReadyToBootGuid,\r
                  &mBootGraphicsReadyToBootEvent\r
                  );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  return Status;\r
}\r