MdeModulePkg/Include/Guid/SmmVariableCommon.h

   1 /** @file
   2   The file defined some common structures used for communicating between SMM variable module and SMM variable wrapper module.
   3
   4 Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
   5 This program and the accompanying materials are licensed and made available under
   6 the terms and conditions of the BSD License that accompanies this distribution.
   7 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 _SMM_VARIABLE_COMMON_H_
  16 #define _SMM_VARIABLE_COMMON_H_
  17
  18 #include <Protocol/VarCheck.h>
  19
  20 #define EFI_SMM_VARIABLE_WRITE_GUID \
  21   { 0x93ba1826, 0xdffb, 0x45dd, { 0x82, 0xa7, 0xe7, 0xdc, 0xaa, 0x3b, 0xbd, 0xf3 } }
  22
  23 extern EFI_GUID gSmmVariableWriteGuid;
  24
  25 //
  26 // This structure is used for SMM variable. the collected statistics data is saved in SMRAM. It can be got from
  27 // SMI handler. The communication buffer should be:
  28 // EFI_SMM_COMMUNICATE_HEADER + SMM_VARIABLE_COMMUNICATE_HEADER + payload.
  29 //
  30 typedef struct {
  31   UINTN       Function;
  32   EFI_STATUS  ReturnStatus;
  33   UINT8       Data[1];
  34 } SMM_VARIABLE_COMMUNICATE_HEADER;
  35
  36 //
  37 // The payload for this function is SMM_VARIABLE_COMMUNICATE_ACCESS_VARIABLE.
  38 //
  39 #define SMM_VARIABLE_FUNCTION_GET_VARIABLE            1
  40 //
  41 // The payload for this function is SMM_VARIABLE_COMMUNICATE_GET_NEXT_VARIABLE_NAME.
  42 //
  43 #define SMM_VARIABLE_FUNCTION_GET_NEXT_VARIABLE_NAME  2
  44 //
  45 // The payload for this function is SMM_VARIABLE_COMMUNICATE_ACCESS_VARIABLE.
  46 //
  47 #define SMM_VARIABLE_FUNCTION_SET_VARIABLE            3
  48 //
  49 // The payload for this function is SMM_VARIABLE_COMMUNICATE_QUERY_VARIABLE_INFO.
  50 //
  51 #define SMM_VARIABLE_FUNCTION_QUERY_VARIABLE_INFO     4
  52 //
  53 // It is a notify event, no extra payload for this function.
  54 //
  55 #define SMM_VARIABLE_FUNCTION_READY_TO_BOOT           5
  56 //
  57 // It is a notify event, no extra payload for this function.
  58 //
  59 #define SMM_VARIABLE_FUNCTION_EXIT_BOOT_SERVICE       6
  60 //
  61 // The payload for this function is VARIABLE_INFO_ENTRY. The GUID in EFI_SMM_COMMUNICATE_HEADER
  62 // is gEfiSmmVariableProtocolGuid.
  63 //
  64 #define SMM_VARIABLE_FUNCTION_GET_STATISTICS          7
  65 //
  66 // The payload for this function is SMM_VARIABLE_COMMUNICATE_LOCK_VARIABLE
  67 //
  68 #define SMM_VARIABLE_FUNCTION_LOCK_VARIABLE           8
  69
  70 #define SMM_VARIABLE_FUNCTION_VAR_CHECK_VARIABLE_PROPERTY_SET  9
  71
  72 #define SMM_VARIABLE_FUNCTION_VAR_CHECK_VARIABLE_PROPERTY_GET  10
  73
  74 ///
  75 /// Size of SMM communicate header, without including the payload.
  76 ///
  77 #define SMM_COMMUNICATE_HEADER_SIZE  (OFFSET_OF (EFI_SMM_COMMUNICATE_HEADER, Data))
  78
  79 ///
  80 /// Size of SMM variable communicate header, without including the payload.
  81 ///
  82 #define SMM_VARIABLE_COMMUNICATE_HEADER_SIZE  (OFFSET_OF (SMM_VARIABLE_COMMUNICATE_HEADER, Data))
  83
  84 ///
  85 /// This structure is used to communicate with SMI handler by SetVariable and GetVariable.
  86 ///
  87 typedef struct {
  88   EFI_GUID    Guid;
  89   UINTN       DataSize;
  90   UINTN       NameSize;
  91   UINT32      Attributes;
  92   CHAR16      Name[1];
  93 } SMM_VARIABLE_COMMUNICATE_ACCESS_VARIABLE;
  94
  95 ///
  96 /// This structure is used to communicate with SMI handler by GetNextVariableName.
  97 ///
  98 typedef struct {
  99   EFI_GUID    Guid;
 100   UINTN       NameSize;     // Return name buffer size
 101   CHAR16      Name[1];
 102 } SMM_VARIABLE_COMMUNICATE_GET_NEXT_VARIABLE_NAME;
 103
 104 ///
 105 /// This structure is used to communicate with SMI handler by QueryVariableInfo.
 106 ///
 107 typedef struct {
 108   UINT64          MaximumVariableStorageSize;
 109   UINT64          RemainingVariableStorageSize;
 110   UINT64          MaximumVariableSize;
 111   UINT32          Attributes;
 112 } SMM_VARIABLE_COMMUNICATE_QUERY_VARIABLE_INFO;
 113
 114 typedef SMM_VARIABLE_COMMUNICATE_GET_NEXT_VARIABLE_NAME SMM_VARIABLE_COMMUNICATE_LOCK_VARIABLE;
 115
 116 typedef struct {
 117   EFI_GUID                      Guid;
 118   UINTN                         NameSize;
 119   VAR_CHECK_VARIABLE_PROPERTY   VariableProperty;
 120   CHAR16                        Name[1];
 121 } SMM_VARIABLE_COMMUNICATE_VAR_CHECK_VARIABLE_PROPERTY;
 122
 123 #endif // _SMM_VARIABLE_COMMON_H_