| /** @file |
| Provides a service to retrieve a pointer to the PEI Services Table. |
| |
| Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR> |
| This program and the accompanying materials |
| are licensed and made available under the terms and conditions of the BSD License |
| which accompanies this distribution. The full text of the license may be found at |
| http://opensource.org/licenses/bsd-license.php |
| |
| THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, |
| WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. |
| |
| **/ |
| |
| #ifndef __PEI_SERVICES_TABLE_POINTER_LIB_H__ |
| #define __PEI_SERVICES_TABLE_POINTER_LIB_H__ |
| |
| /** |
| Retrieves the cached value of the PEI Services Table pointer. |
| |
| Returns the cached value of the PEI Services Table pointer in a CPU specific manner |
| as specified in the CPU binding section of the Platform Initialization Pre-EFI |
| Initialization Core Interface Specification. |
| |
| If the cached PEI Services Table pointer is NULL, then ASSERT(). |
| |
| @return The pointer to PeiServices. |
| |
| **/ |
| CONST EFI_PEI_SERVICES ** |
| EFIAPI |
| GetPeiServicesTablePointer ( |
| VOID |
| ); |
| |
| /** |
| Caches a pointer PEI Services Table. |
| |
| Caches the pointer to the PEI Services Table specified by PeiServicesTablePointer |
| in a CPU specific manner as specified in the CPU binding section of the Platform Initialization |
| Pre-EFI Initialization Core Interface Specification. |
| |
| If PeiServicesTablePointer is NULL, then ASSERT(). |
| |
| @param PeiServicesTablePointer The address of PeiServices pointer. |
| **/ |
| VOID |
| EFIAPI |
| SetPeiServicesTablePointer ( |
| IN CONST EFI_PEI_SERVICES ** PeiServicesTablePointer |
| ); |
| |
| /** |
| Perform CPU specific actions required to migrate the PEI Services Table |
| pointer from temporary RAM to permanent RAM. |
| |
| For IA32 CPUs, the PEI Services Table pointer is stored in the 4 bytes |
| immediately preceding the Interrupt Descriptor Table (IDT) in memory. |
| For X64 CPUs, the PEI Services Table pointer is stored in the 8 bytes |
| immediately preceding the Interrupt Descriptor Table (IDT) in memory. |
| For Itanium and ARM CPUs, a the PEI Services Table Pointer is stored in |
| a dedicated CPU register. This means that there is no memory storage |
| associated with storing the PEI Services Table pointer, so no additional |
| migration actions are required for Itanium or ARM CPUs. |
| |
| **/ |
| VOID |
| EFIAPI |
| MigratePeiServicesTablePointer ( |
| VOID |
| ); |
| |
| #endif |
| |