IntelFrameworkModulePkg/Library/GenericBdsLib/InternalBdsLib.h

   1 /** @file
   2   BDS library definition, include the file and data structure
   3
   4 Copyright (c) 2004 - 2013, Intel Corporation. All rights reserved.<BR>
   5 This program and the accompanying materials
   6 are licensed and made available under the terms and conditions of the BSD License
   7 which accompanies this distribution.  The full text of the license may be found at
   8 http://opensource.org/licenses/bsd-license.php
   9
  10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13 **/
  14
  15 #ifndef _INTERNAL_BDS_LIB_H_
  16 #define _INTERNAL_BDS_LIB_H_
  17
  18 #include <FrameworkDxe.h>
  19
  20 #include <IndustryStandard/Pci.h>
  21 #include <IndustryStandard/PeImage.h>
  22
  23 #include <Protocol/BlockIo.h>
  24 #include <Protocol/LoadedImage.h>
  25 #include <Protocol/Cpu.h>
  26 #include <Protocol/SimpleFileSystem.h>
  27 #include <Protocol/LoadFile.h>
  28 #include <Protocol/DebugPort.h>
  29 #include <Protocol/DevicePath.h>
  30 #include <Protocol/SimpleTextIn.h>
  31 #include <Protocol/LegacyBios.h>
  32 #include <Protocol/SimpleTextOut.h>
  33 #include <Protocol/SimpleNetwork.h>
  34 #include <Protocol/DevicePathToText.h>
  35 #include <Protocol/FirmwareVolume2.h>
  36 #include <Protocol/PciIo.h>
  37 #include <Protocol/AcpiS3Save.h>
  38 #include <Protocol/OEMBadging.h>
  39 #include <Protocol/GraphicsOutput.h>
  40 #include <Protocol/UgaDraw.h>
  41 #include <Protocol/HiiFont.h>
  42 #include <Protocol/HiiImage.h>
  43 #include <Protocol/UsbIo.h>
  44 #include <Protocol/BootLogo.h>
  45
  46 #include <Guid/MemoryTypeInformation.h>
  47 #include <Guid/FileInfo.h>
  48 #include <Guid/GlobalVariable.h>
  49 #include <Guid/PcAnsi.h>
  50 #include <Guid/Performance.h>
  51 #include <Guid/BdsLibHii.h>
  52 #include <Guid/HdBootVariable.h>
  53 #include <Guid/LastEnumLang.h>
  54 #include <Guid/LegacyDevOrder.h>
  55
  56 #include <Library/PrintLib.h>
  57 #include <Library/DebugLib.h>
  58 #include <Library/BaseMemoryLib.h>
  59 #include <Library/UefiBootServicesTableLib.h>
  60 #include <Library/UefiLib.h>
  61 #include <Library/MemoryAllocationLib.h>
  62 #include <Library/DxeServicesTableLib.h>
  63 #include <Library/UefiRuntimeServicesTableLib.h>
  64 #include <Library/HobLib.h>
  65 #include <Library/BaseLib.h>
  66 #include <Library/DevicePathLib.h>
  67 #include <Library/PerformanceLib.h>
  68 #include <Library/PcdLib.h>
  69 #include <Library/PeCoffGetEntryPointLib.h>
  70 #include <Library/GenericBdsLib.h>
  71 #include <Library/TimerLib.h>
  72 #include <Library/PcdLib.h>
  73 #include <Library/DxeServicesLib.h>
  74 #include <Library/ReportStatusCodeLib.h>
  75
  76 #if !defined (EFI_REMOVABLE_MEDIA_FILE_NAME)
  77     #if defined (MDE_CPU_EBC)
  78         //
  79         // Uefi specification only defines the default boot file name for IA32, X64
  80         // and IPF processor, so need define boot file name for EBC architecture here.
  81         //
  82         #define EFI_REMOVABLE_MEDIA_FILE_NAME L"\\EFI\\BOOT\\BOOTEBC.EFI"
  83     #else
  84         #error "Can not determine the default boot file name for unknown processor type!"
  85     #endif
  86 #endif
  87
  88 /**
  89
  90   Writes performance data of booting into the allocated memory.
  91   OS can process these records.
  92
  93   @param  Event                 The triggered event.
  94   @param  Context               Context for this event.
  95
  96 **/
  97 VOID
  98 EFIAPI
  99 WriteBootToOsPerformanceData (
 100   IN EFI_EVENT  Event,
 101   IN VOID       *Context
 102   );
 103
 104 /**
 105   Get the headers (dos, image, optional header) from an image
 106
 107   @param  Device                SimpleFileSystem device handle
 108   @param  FileName              File name for the image
 109   @param  DosHeader             Pointer to dos header
 110   @param  Hdr                   The buffer in which to return the PE32, PE32+, or TE header.
 111
 112   @retval EFI_SUCCESS           Successfully get the machine type.
 113   @retval EFI_NOT_FOUND         The file is not found.
 114   @retval EFI_LOAD_ERROR        File is not a valid image file.
 115
 116 **/
 117 EFI_STATUS
 118 EFIAPI
 119 BdsLibGetImageHeader (
 120   IN  EFI_HANDLE                  Device,
 121   IN  CHAR16                      *FileName,
 122   OUT EFI_IMAGE_DOS_HEADER        *DosHeader,
 123   OUT EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION   Hdr
 124   );
 125
 126 /**
 127   This routine adjust the memory information for different memory type and
 128   save them into the variables for next boot.
 129 **/
 130 VOID
 131 BdsSetMemoryTypeInformationVariable (
 132   VOID
 133   );
 134
 135 /**
 136   Validate the EFI Boot#### or Driver#### variable (VendorGuid/Name)
 137
 138   @param  Variable              Boot#### variable data.
 139   @param  VariableSize          Returns the size of the EFI variable that was read
 140
 141   @retval TRUE                  The variable data is correct.
 142   @retval FALSE                 The variable data is corrupted.
 143
 144 **/
 145 BOOLEAN
 146 ValidateOption (
 147   UINT8                     *Variable,
 148   UINTN                     VariableSize
 149   );
 150
 151 #endif // _BDS_LIB_H_