X-Git-Url: https://git.proxmox.com/?p=mirror_edk2.git;a=blobdiff_plain;f=IntelFrameworkPkg%2FInclude%2FPpi%2FS3Resume.h;h=b04a62ab792c4ca0179fb3a778f9654e92d9b53f;hp=cbb38f5722d6f892037f5071c48906dd4e15697b;hb=4a71b21a6375549aa514e4680449a29f9c64802f;hpb=f42be64210ea5ef394835a3c35f0444086537f66

diff --git a/IntelFrameworkPkg/Include/Ppi/S3Resume.h b/IntelFrameworkPkg/Include/Ppi/S3Resume.h
index cbb38f5722..b04a62ab79 100644
--- a/IntelFrameworkPkg/Include/Ppi/S3Resume.h
+++ b/IntelFrameworkPkg/Include/Ppi/S3Resume.h
@@ -1,6 +1,22 @@
 /** @file
-  This file declares S3 Resume PPI.
-
+  This file declares S3 Resume PPI which accomplishes the firmware S3 resume boot path
+  and transfers control to OS.
+  
+  This PPI is published by the S3 resume PEIM and can be used on the S3 resume boot path to
+  restore the platform to its preboot configuration and transfer control to OS. The information that is
+  required for an S3 resume can be saved during the normal boot path using
+  EFI_ACPI_S3_SAVE_PROTOCOL. This presaved information can then be restored in the S3
+  resume boot path using EFI_PEI_S3_RESUME_PPI. Architecturally, the S3 resume PEIM is the
+  last PEIM to be dispatched in the S3 resume boot path.
+  Before using this PPI, the caller has to ensure the necessary information for the S3 resume, such as
+  the following, is available for the S3 resume boot path:
+  - EFI_ACPI_S3_RESUME_SCRIPT_TABLE script table. Type
+    EFI_ACPI_S3_RESUME_SCRIPT_TABLE is defined in the Intel® Platform Innovation
+    Framework for EFI Boot Script Specification.
+  - OS waking vector.
+  - The reserved memory range to be used for the S3 resume.
+  Otherwise, the S3 resume boot path may fail.
+  
   Copyright (c) 2007, 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