MdeModulePkg: Replace BSD License with BSD+Patent License

[mirror_edk2.git] / MdeModulePkg / Core / Dxe / Image / Image.h

/** @file\r
  Data structure and functions to load and unload PeImage.\r
\r
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
\r
#ifndef _IMAGE_H_\r
#define _IMAGE_H_\r
\r
#define LOAD_PE32_IMAGE_PRIVATE_DATA_SIGNATURE  SIGNATURE_32('l','p','e','i')\r
\r
typedef struct {\r
  UINTN                       Signature;\r
  /// Image handle\r
  EFI_HANDLE                  Handle;\r
  EFI_PE32_IMAGE_PROTOCOL     Pe32Image;\r
} LOAD_PE32_IMAGE_PRIVATE_DATA;\r
\r
#define LOAD_PE32_IMAGE_PRIVATE_DATA_FROM_THIS(a) \\r
          CR(a, LOAD_PE32_IMAGE_PRIVATE_DATA, Pe32Image, LOAD_PE32_IMAGE_PRIVATE_DATA_SIGNATURE)\r
\r
\r
//\r
// Private Data Types\r
//\r
#define IMAGE_FILE_HANDLE_SIGNATURE       SIGNATURE_32('i','m','g','f')\r
typedef struct {\r
  UINTN               Signature;\r
  BOOLEAN             FreeBuffer;\r
  VOID                *Source;\r
  UINTN               SourceSize;\r
} IMAGE_FILE_HANDLE;\r
\r
/**\r
  Loads an EFI image into memory and returns a handle to the image with extended parameters.\r
\r
  @param  This                    Calling context\r
  @param  ParentImageHandle       The caller's image handle.\r
  @param  FilePath                The specific file path from which the image is\r
                                  loaded.\r
  @param  SourceBuffer            If not NULL, a pointer to the memory location\r
                                  containing a copy of the image to be loaded.\r
  @param  SourceSize              The size in bytes of SourceBuffer.\r
  @param  DstBuffer               The buffer to store the image.\r
  @param  NumberOfPages           For input, specifies the space size of the\r
                                  image by caller if not NULL. For output,\r
                                  specifies the actual space size needed.\r
  @param  ImageHandle             Image handle for output.\r
  @param  EntryPoint              Image entry point for output.\r
  @param  Attribute               The bit mask of attributes to set for the load\r
                                  PE image.\r
\r
  @retval EFI_SUCCESS             The image was loaded into memory.\r
  @retval EFI_NOT_FOUND           The FilePath was not found.\r
  @retval EFI_INVALID_PARAMETER   One of the parameters has an invalid value.\r
  @retval EFI_UNSUPPORTED         The image type is not supported, or the device\r
                                  path cannot be parsed to locate the proper\r
                                  protocol for loading the file.\r
  @retval EFI_OUT_OF_RESOURCES    Image was not loaded due to insufficient\r
                                  resources.\r
  @retval EFI_LOAD_ERROR          Image was not loaded because the image format was corrupt or not\r
                                  understood.\r
  @retval EFI_DEVICE_ERROR        Image was not loaded because the device returned a read error.\r
  @retval EFI_ACCESS_DENIED       Image was not loaded because the platform policy prohibits the\r
                                  image from being loaded. NULL is returned in *ImageHandle.\r
  @retval EFI_SECURITY_VIOLATION  Image was loaded and an ImageHandle was created with a\r
                                  valid EFI_LOADED_IMAGE_PROTOCOL. However, the current\r
                                  platform policy specifies that the image should not be started.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreLoadImageEx (\r
  IN  EFI_PE32_IMAGE_PROTOCOL          *This,\r
  IN  EFI_HANDLE                       ParentImageHandle,\r
  IN  EFI_DEVICE_PATH_PROTOCOL         *FilePath,\r
  IN  VOID                             *SourceBuffer       OPTIONAL,\r
  IN  UINTN                            SourceSize,\r
  IN  EFI_PHYSICAL_ADDRESS             DstBuffer           OPTIONAL,\r
  OUT UINTN                            *NumberOfPages      OPTIONAL,\r
  OUT EFI_HANDLE                       *ImageHandle,\r
  OUT EFI_PHYSICAL_ADDRESS             *EntryPoint         OPTIONAL,\r
  IN  UINT32                           Attribute\r
  );\r
\r
\r
/**\r
  Unload the specified image.\r
\r
  @param  This                    Indicates the calling context.\r
  @param  ImageHandle             The specified image handle.\r
\r
  @retval EFI_INVALID_PARAMETER   Image handle is NULL.\r
  @retval EFI_UNSUPPORTED         Attempt to unload an unsupported image.\r
  @retval EFI_SUCCESS             Image successfully unloaded.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreUnloadImageEx (\r
  IN EFI_PE32_IMAGE_PROTOCOL  *This,\r
  IN EFI_HANDLE                         ImageHandle\r
  );\r
#endif\r