2 Module produce EFI_PEI_READ_ONLY_VARIABLE_PPI on top of EFI_PEI_READ_ONLY_VARIABLE2_PPI.
3 UEFI PI Spec supersedes Intel's Framework Specs.
4 # EFI_PEI_READ_ONLY_VARIABLE_PPI defined in Intel Framework Pkg is replaced by EFI_PEI_READ_ONLY_VARIABLE2_PPI
6 # This module produces EFI_PEI_READ_ONLY_VARIABLE_PPI on top of EFI_PEI_READ_ONLY_VARIABLE2_PPI.
7 # This module is used on platform when both of these two conditions are true:
8 # 1) Framework module consumes EFI_PEI_READ_ONLY_VARIABLE_PPI is present.
9 # 2) The platform has a PI module that only produces EFI_PEI_READ_ONLY_VARIABLE2_PPI.
11 This module can't be used together with ReadOnlyVariable2ToReadOnlyVariableThunk module.
13 Copyright (c) 2006 - 2008 Intel Corporation. <BR>
14 All rights reserved. This program and the accompanying materials
15 are licensed and made available under the terms and conditions of the BSD License
16 which accompanies this distribution. The full text of the license may be found at
17 http://opensource.org/licenses/bsd-license.php
19 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
20 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
26 #include <Ppi/ReadOnlyVariable.h>
27 #include <Ppi/ReadOnlyVariable2.h>
28 #include <Ppi/ReadOnlyVariableThunkPresent.h>
29 #include <Library/DebugLib.h>
30 #include <Library/PeiServicesLib.h>
33 // Function Prototypes
38 IN EFI_PEI_SERVICES
**PeiServices
,
39 IN CHAR16
*VariableName
,
40 IN EFI_GUID
*VendorGuid
,
41 OUT UINT32
*Attributes OPTIONAL
,
42 IN OUT UINTN
*DataSize
,
48 PeiGetNextVariableName (
49 IN EFI_PEI_SERVICES
**PeiServices
,
50 IN OUT UINTN
*VariableNameSize
,
51 IN OUT CHAR16
*VariableName
,
52 IN OUT EFI_GUID
*VendorGuid
58 EFI_PEI_READ_ONLY_VARIABLE_PPI mVariablePpi
= {
60 PeiGetNextVariableName
63 EFI_PEI_PPI_DESCRIPTOR mPpiListVariable
= {
64 (EFI_PEI_PPI_DESCRIPTOR_PPI
| EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST
),
65 &gEfiPeiReadOnlyVariablePpiGuid
,
70 Standard entry point of a PEIM.
72 @param FfsHeadher The FFS file header
73 @param PeiServices General purpose services available to every PEIM.
75 @retval EFI_SUCCESS If the gEfiPeiReadOnlyVariablePpiGuid interface could be successfully installed.
80 PeimInitializeReadOnlyVariable (
81 IN EFI_PEI_FILE_HANDLE FfsHeader
,
82 IN CONST EFI_PEI_SERVICES
**PeiServices
89 // Make sure ReadOnlyVariableToReadOnlyVariable2 module is not present. If so, the call chain will form a
90 // infinite loop: ReadOnlyVariable -> ReadOnlyVariable2 -> ReadOnlyVariable -> ....
92 Status
= PeiServicesLocatePpi (&gPeiReadonlyVariableThunkPresentPpiGuid
, 0, NULL
, &Interface
);
93 ASSERT (Status
== EFI_NOT_FOUND
);
96 // Publish the variable capability to other modules
98 return (*PeiServices
)->InstallPpi (PeiServices
, &mPpiListVariable
);
104 IN EFI_PEI_SERVICES
**PeiServices
,
105 IN CHAR16
*VariableName
,
106 IN EFI_GUID
*VendorGuid
,
107 OUT UINT32
*Attributes OPTIONAL
,
108 IN OUT UINTN
*DataSize
,
115 Provide the read variable functionality of the variable services.
119 PeiServices - General purpose services available to every PEIM.
121 VariableName - The variable name
123 VendorGuid - The vendor's GUID
125 Attributes - Pointer to the attribute
127 DataSize - Size of data
129 Data - Pointer to data
133 EFI_SUCCESS - The interface could be successfully installed
135 EFI_NOT_FOUND - The variable could not be discovered
137 EFI_BUFFER_TOO_SMALL - The caller buffer is not large enough
142 EFI_PEI_READ_ONLY_VARIABLE2_PPI
*ReadOnlyVariable2
;
144 Status
= (*PeiServices
)->LocatePpi (
145 (CONST EFI_PEI_SERVICES
**)PeiServices
,
146 &gEfiPeiReadOnlyVariable2PpiGuid
,
149 (VOID
**)&ReadOnlyVariable2
151 ASSERT_EFI_ERROR (Status
);
153 return ReadOnlyVariable2
->GetVariable (
165 PeiGetNextVariableName (
166 IN EFI_PEI_SERVICES
**PeiServices
,
167 IN OUT UINTN
*VariableNameSize
,
168 IN OUT CHAR16
*VariableName
,
169 IN OUT EFI_GUID
*VendorGuid
175 Provide the get next variable functionality of the variable services.
179 PeiServices - General purpose services available to every PEIM.
180 VariabvleNameSize - The variable name's size.
181 VariableName - A pointer to the variable's name.
182 VariableGuid - A pointer to the EFI_GUID structure.
184 VariableNameSize - Size of the variable name
186 VariableName - The variable name
188 VendorGuid - The vendor's GUID
192 EFI_SUCCESS - The interface could be successfully installed
194 EFI_NOT_FOUND - The variable could not be discovered
199 EFI_PEI_READ_ONLY_VARIABLE2_PPI
*ReadOnlyVariable2
;
201 Status
= (*PeiServices
)->LocatePpi (
202 (CONST EFI_PEI_SERVICES
**)PeiServices
,
203 &gEfiPeiReadOnlyVariable2PpiGuid
,
206 (VOID
**)&ReadOnlyVariable2
208 ASSERT_EFI_ERROR (Status
);
210 return ReadOnlyVariable2
->NextVariableName (