+++ /dev/null
-/** @file\r
- This file declares S3 Resume PPI which accomplishes the firmware S3 resume boot path\r
- and transfers control to OS.\r
-\r
- This PPI is published by the S3 resume PEIM and can be used on the S3 resume boot path to\r
- restore the platform to its preboot configuration and transfer control to OS. The information that is\r
- required for an S3 resume can be saved during the normal boot path using\r
- EFI_ACPI_S3_SAVE_PROTOCOL. This presaved information can then be restored in the S3\r
- resume boot path using EFI_PEI_S3_RESUME_PPI. Architecturally, the S3 resume PEIM is the\r
- last PEIM to be dispatched in the S3 resume boot path.\r
- Before using this PPI, the caller must ensure the necessary information for the S3 resume, such as\r
- the following, is available for the S3 resume boot path:\r
- - EFI_ACPI_S3_RESUME_SCRIPT_TABLE script table. Type\r
- EFI_ACPI_S3_RESUME_SCRIPT_TABLE is defined in the Intel Platform Innovation\r
- Framework for EFI Boot Script Specification.\r
- - OS waking vector.\r
- - The reserved memory range to be used for the S3 resume.\r
- Otherwise, the S3 resume boot path may fail.\r
-\r
-Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>\r
-SPDX-License-Identifier: BSD-2-Clause-Patent\r
-\r
- @par Revision Reference:\r
- This PPI is defined in Framework for EFI S3 Resume Boot Path spec.\r
- Version 0.9.\r
-\r
-**/\r
-\r
-#ifndef __PEI_S3_RESUME_PPI_H__\r
-#define __PEI_S3_RESUME_PPI_H__\r
-\r
-#define EFI_PEI_S3_RESUME_PPI_GUID \\r
- { \\r
- 0x4426CCB2, 0xE684, 0x4a8a, {0xAE, 0x40, 0x20, 0xD4, 0xB0, 0x25, 0xB7, 0x10 } \\r
- }\r
-\r
-typedef struct _EFI_PEI_S3_RESUME_PPI EFI_PEI_S3_RESUME_PPI;\r
-\r
-/**\r
- Restores the platform to its preboot configuration for an S3 resume and\r
- jumps to the OS waking vector.\r
-\r
- @param PeiServices The pointer to the PEI Services Table\r
-\r
- @retval EFI_ABORTED Execution of the S3 resume boot script table failed.\r
- @retval EFI_NOT_FOUND Could not be locate some necessary information that\r
- is used for the S3 resume boot path d.\r
-\r
-**/\r
-typedef\r
-EFI_STATUS\r
-(EFIAPI *EFI_PEI_S3_RESUME_PPI_RESTORE_CONFIG)(\r
- IN EFI_PEI_SERVICES **PeiServices\r
- );\r
-\r
-/**\r
- EFI_PEI_S3_RESUME_PPI accomplishes the firmware S3 resume boot\r
- path and transfers control to OS.\r
-**/\r
-struct _EFI_PEI_S3_RESUME_PPI {\r
- ///\r
- /// Restores the platform to its preboot configuration for an S3 resume and\r
- /// jumps to the OS waking vector.\r
- ///\r
- EFI_PEI_S3_RESUME_PPI_RESTORE_CONFIG S3RestoreConfig;\r
-};\r
-\r
-extern EFI_GUID gEfiPeiS3ResumePpiGuid;\r
-\r
-#endif\r