MdePkg/Include/Library/PeiServicesTablePointerLib.h File Reference


Functions

CONST EFI_PEI_SERVICES **EFIAPI GetPeiServicesTablePointer (VOID)
VOID EFIAPI SetPeiServicesTablePointer (IN CONST EFI_PEI_SERVICES **PeiServicesTablePointer)
VOID EFIAPI MigratePeiServicesTablePointer (VOID)

Detailed Description

Provides a service to retrieve a pointer to the PEI Services Table.

Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.
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.


Function Documentation

CONST EFI_PEI_SERVICES** EFIAPI GetPeiServicesTablePointer ( VOID   ) 

VOID EFIAPI MigratePeiServicesTablePointer ( VOID   ) 

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.

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.

If The cached PEI Services Table pointer is NULL, then ASSERT(). If the permanent memory is allocated failed, then ASSERT().

References AsmReadIdtr(), AsmWriteIdtr(), ASSERT, ASSERT_EFI_ERROR, IA32_DESCRIPTOR::Base, CONST, CopyMem(), EFI_SIZE_TO_PAGES, EfiBootServicesCode, IA32_DESCRIPTOR::Limit, NULL, and VOID.

VOID EFIAPI SetPeiServicesTablePointer ( IN CONST EFI_PEI_SERVICES **  PeiServicesTablePointer  ) 

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().

Parameters:
PeiServicesTablePointer The address of PeiServices pointer.
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. The function set the pointer of PEI services immediately preceding the IDT table according to PI specification.

If PeiServicesTablePointer is NULL, then ASSERT().

Parameters:
PeiServicesTablePointer The address of PeiServices pointer.
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. The function set the pointer of PEI services in KR7 register according to PI specification.

If PeiServicesTablePointer is NULL, then ASSERT().

Parameters:
PeiServicesTablePointer The address of PeiServices pointer.

References AsmReadIdtr(), AsmWriteKr7(), ASSERT, IA32_DESCRIPTOR::Base, gPeiServices, and NULL.


Generated on Thu Sep 24 23:14:17 2015 for MdePkg[ALL] by  doxygen 1.5.7.1