IntelFrameworkPkg: Replace BSD License with BSD+Patent License

[mirror_edk2.git] / IntelFrameworkPkg / Include / Protocol / LegacyRegion.h

/** @file\r
  This protocol manages the legacy memory regions between 0xc0000 - 0xfffff.\r
\r
Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
  @par Revision Reference:\r
  This protocol is defined in Framework for EFI Compatibility Support Module spec\r
  Version 0.97.\r
\r
**/\r
\r
#ifndef _EFI_LEGACY_REGION_H_\r
#define _EFI_LEGACY_REGION_H_\r
\r
\r
#define EFI_LEGACY_REGION_PROTOCOL_GUID \\r
  { \\r
    0xfc9013a, 0x568, 0x4ba9, {0x9b, 0x7e, 0xc9, 0xc3, 0x90, 0xa6, 0x60, 0x9b } \\r
  }\r
\r
typedef struct _EFI_LEGACY_REGION_PROTOCOL EFI_LEGACY_REGION_PROTOCOL;\r
\r
/**\r
  Sets hardware to decode or not decode a region.\r
\r
  @param  This                  Indicates the EFI_LEGACY_REGION_PROTOCOL instance\r
  @param  Start                 The start of the region to decode.\r
  @param  Length                The size in bytes of the region.\r
  @param  On                    The decode/nondecode flag.\r
\r
  @retval EFI_SUCCESS           The decode range successfully changed.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_LEGACY_REGION_DECODE)(\r
  IN EFI_LEGACY_REGION_PROTOCOL           *This,\r
  IN  UINT32                              Start,\r
  IN  UINT32                              Length,\r
  IN  BOOLEAN                             *On\r
  );\r
\r
/**\r
  Sets a region to read only.\r
\r
  @param  This                  Indicates the EFI_LEGACY_REGION_PROTOCOL instance.\r
  @param  Start                 The start of region to lock.\r
  @param  Length                The size in bytes of the region.\r
  @param  Granularity           Lock attribute affects this granularity in bytes.\r
\r
  @retval EFI_SUCCESS           The region was made read only.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_LEGACY_REGION_LOCK)(\r
  IN EFI_LEGACY_REGION_PROTOCOL           *This,\r
  IN  UINT32                              Start,\r
  IN  UINT32                              Length,\r
  OUT UINT32                              *Granularity OPTIONAL\r
  );\r
\r
/**\r
  Sets a region to read only and ensures that flash is locked from being\r
  inadvertently modified.\r
\r
  @param  This                  Indicates the EFI_LEGACY_REGION_PROTOCOL instance\r
  @param  Start                 The start of region to lock.\r
  @param  Length                The size in bytes of the region.\r
  @param  Granularity           Lock attribute affects this granularity in bytes.\r
\r
  @retval EFI_SUCCESS           The region was made read only and flash is locked.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_LEGACY_REGION_BOOT_LOCK)(\r
  IN EFI_LEGACY_REGION_PROTOCOL           *This,\r
  IN  UINT32                              Start,\r
  IN  UINT32                              Length,\r
  OUT UINT32                              *Granularity OPTIONAL\r
  );\r
\r
/**\r
  Sets a region to read-write.\r
\r
  @param  This                  Indicates the EFI_LEGACY_REGION_PROTOCOL instance\r
  @param  Start                 The start of region to lock.\r
  @param  Length                The size in bytes of the region.\r
  @param  Granularity           Lock attribute affects this granularity in bytes.\r
\r
  @retval EFI_SUCCESS           The region was successfully made read-write.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_LEGACY_REGION_UNLOCK)(\r
  IN EFI_LEGACY_REGION_PROTOCOL           *This,\r
  IN  UINT32                              Start,\r
  IN  UINT32                              Length,\r
  OUT UINT32                              *Granularity OPTIONAL\r
  );\r
\r
/**\r
  Abstracts the hardware control of the physical address region 0xC0000-C0xFFFFF\r
  for the traditional BIOS.\r
**/\r
struct _EFI_LEGACY_REGION_PROTOCOL {\r
  EFI_LEGACY_REGION_DECODE    Decode;     ///< Specifies a region for the chipset to decode.\r
  EFI_LEGACY_REGION_LOCK      Lock;       ///< Makes the specified OpROM region read only or locked.\r
  EFI_LEGACY_REGION_BOOT_LOCK BootLock;   ///< Sets a region to read only and ensures tat flash is locked from.\r
                                          ///< inadvertent modification.\r
  EFI_LEGACY_REGION_UNLOCK    UnLock;     ///< Makes the specified OpROM region read-write or unlocked.\r
};\r
\r
extern EFI_GUID gEfiLegacyRegionProtocolGuid;\r
\r
#endif\r