mirror of
				https://github.com/acidanthera/audk.git
				synced 2025-11-03 21:17:23 +01:00 
			
		
		
		
	Signed-off-by: Star Zeng <star.zeng@intel.com> Reviewed-by: Jiewen Yao <jiewen.yao@intel.com> git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@13952 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			60 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			60 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  This is an implementation of the ACPI S3 Save protocol.  This is defined in 
 | 
						|
  S3 boot path specification 0.9.
 | 
						|
 | 
						|
Copyright (c) 2006 - 2012, 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 _ACPI_S3_SAVE_H_
 | 
						|
#define _ACPI_S3_SAVE_H_
 | 
						|
 | 
						|
/**
 | 
						|
  Gets the buffer of legacy memory below 1 MB 
 | 
						|
  This function is to get the buffer in legacy memory below 1MB that is required during S3 resume.
 | 
						|
 | 
						|
  @param This           A pointer to the EFI_ACPI_S3_SAVE_PROTOCOL instance.
 | 
						|
  @param Size           The returned size of legacy memory below 1 MB.
 | 
						|
 | 
						|
  @retval EFI_SUCCESS           Size is successfully returned.
 | 
						|
  @retval EFI_INVALID_PARAMETER The pointer Size is NULL.
 | 
						|
 | 
						|
**/
 | 
						|
EFI_STATUS
 | 
						|
EFIAPI
 | 
						|
LegacyGetS3MemorySize (
 | 
						|
  IN  EFI_ACPI_S3_SAVE_PROTOCOL    * This,
 | 
						|
  OUT UINTN                        * Size
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  Prepares all information that is needed in the S3 resume boot path.
 | 
						|
  
 | 
						|
  Allocate the resources or prepare informations and save in ACPI variable set for S3 resume boot path  
 | 
						|
  
 | 
						|
  @param This                 A pointer to the EFI_ACPI_S3_SAVE_PROTOCOL instance.
 | 
						|
  @param LegacyMemoryAddress  The base address of legacy memory.
 | 
						|
 | 
						|
  @retval EFI_NOT_FOUND         Some necessary information cannot be found.
 | 
						|
  @retval EFI_SUCCESS           All information was saved successfully.
 | 
						|
  @retval EFI_OUT_OF_RESOURCES  Resources were insufficient to save all the information.
 | 
						|
  @retval EFI_INVALID_PARAMETER The memory range is not located below 1 MB.
 | 
						|
 | 
						|
**/
 | 
						|
EFI_STATUS
 | 
						|
EFIAPI
 | 
						|
S3Ready (
 | 
						|
  IN EFI_ACPI_S3_SAVE_PROTOCOL     *This,
 | 
						|
  IN VOID                          *LegacyMemoryAddress   
 | 
						|
  );
 | 
						|
#endif
 |