MdePkg/Include/Protocol/MmConfiguration.h

   1 /** @file
   2   EFI MM Configuration Protocol as defined in the PI 1.5 specification.
   3
   4   This protocol is used to:
   5   1) report the portions of MMRAM regions which cannot be used for the MMRAM heap.
   6   2) register the MM Foundation entry point with the processor code. The entry
   7      point will be invoked by the MM processor entry code.
   8
   9   Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>
  10   SPDX-License-Identifier: BSD-2-Clause-Patent
  11
  12 **/
  13
  14 #ifndef _MM_CONFIGURATION_H_
  15 #define _MM_CONFIGURATION_H_
  16
  17 #include <Pi/PiMmCis.h>
  18
  19 #define EFI_MM_CONFIGURATION_PROTOCOL_GUID \
  20   { \
  21     0x26eeb3de, 0xb689, 0x492e, {0x80, 0xf0, 0xbe, 0x8b, 0xd7, 0xda, 0x4b, 0xa7 }  \
  22   }
  23
  24 typedef struct _EFI_MM_CONFIGURATION_PROTOCOL EFI_MM_CONFIGURATION_PROTOCOL;
  25
  26 /**
  27   Register the MM Foundation entry point.
  28
  29   This function registers the MM Foundation entry point with the processor code. This entry point
  30   will be invoked by the MM Processor entry code.
  31
  32   @param[in] This                The EFI_MM_CONFIGURATION_PROTOCOL instance.
  33   @param[in] MmEntryPoint        MM Foundation entry point.
  34
  35   @retval EFI_SUCCESS            Success to register MM Entry Point.
  36   @retval EFI_INVALID_PARAMETER  MmEntryPoint is NULL.
  37 **/
  38 typedef
  39 EFI_STATUS
  40 (EFIAPI *EFI_MM_REGISTER_MM_ENTRY)(
  41   IN CONST EFI_MM_CONFIGURATION_PROTOCOL  *This,
  42   IN EFI_MM_ENTRY_POINT                   MmEntryPoint
  43   );
  44
  45 ///
  46 /// The EFI MM Configuration Protocol is a mandatory protocol published by a DXE CPU driver to
  47 /// indicate which areas within MMRAM are reserved for use by the CPU for any purpose,
  48 /// such as stack, save state or MM entry point.
  49 ///
  50 /// The RegistermmEntry() function allows the MM IPL DXE driver to register the MM
  51 /// Foundation entry point with the MM entry vector code.
  52 ///
  53 struct _EFI_MM_CONFIGURATION_PROTOCOL {
  54   ///
  55   /// A pointer to an array MMRAM ranges used by the initial MM entry code.
  56   ///
  57   EFI_MM_RESERVED_MMRAM_REGION    *MmramReservedRegions;
  58   EFI_MM_REGISTER_MM_ENTRY        RegisterMmEntry;
  59 };
  60
  61 extern EFI_GUID  gEfiMmConfigurationProtocolGuid;
  62
  63 #endif