]>
Commit | Line | Data |
---|---|---|
13d4af68 | 1 | /** @file\r |
0a6f4824 | 2 | This is an implementation of the ACPI S3 Save protocol. This is defined in\r |
13d4af68 | 3 | S3 boot path specification 0.9.\r |
4 | \r | |
0a6f4824 | 5 | Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r |
13d4af68 | 6 | \r |
c0a00b14 | 7 | SPDX-License-Identifier: BSD-2-Clause-Patent\r |
13d4af68 | 8 | \r |
9 | **/\r | |
10 | \r | |
11 | #ifndef _ACPI_S3_SAVE_H_\r | |
12 | #define _ACPI_S3_SAVE_H_\r | |
13 | \r | |
13d4af68 | 14 | /**\r |
0a6f4824 | 15 | Gets the buffer of legacy memory below 1 MB\r |
13d4af68 | 16 | This function is to get the buffer in legacy memory below 1MB that is required during S3 resume.\r |
17 | \r | |
18 | @param This A pointer to the EFI_ACPI_S3_SAVE_PROTOCOL instance.\r | |
19 | @param Size The returned size of legacy memory below 1 MB.\r | |
20 | \r | |
21 | @retval EFI_SUCCESS Size is successfully returned.\r | |
22 | @retval EFI_INVALID_PARAMETER The pointer Size is NULL.\r | |
23 | \r | |
24 | **/\r | |
25 | EFI_STATUS\r | |
26 | EFIAPI\r | |
27 | LegacyGetS3MemorySize (\r | |
28 | IN EFI_ACPI_S3_SAVE_PROTOCOL * This,\r | |
29 | OUT UINTN * Size\r | |
30 | );\r | |
31 | \r | |
32 | /**\r | |
33 | Prepares all information that is needed in the S3 resume boot path.\r | |
0a6f4824 LG |
34 | \r |
35 | Allocate the resources or prepare informations and save in ACPI variable set for S3 resume boot path\r | |
36 | \r | |
13d4af68 | 37 | @param This A pointer to the EFI_ACPI_S3_SAVE_PROTOCOL instance.\r |
38 | @param LegacyMemoryAddress The base address of legacy memory.\r | |
39 | \r | |
40 | @retval EFI_NOT_FOUND Some necessary information cannot be found.\r | |
41 | @retval EFI_SUCCESS All information was saved successfully.\r | |
42 | @retval EFI_OUT_OF_RESOURCES Resources were insufficient to save all the information.\r | |
43 | @retval EFI_INVALID_PARAMETER The memory range is not located below 1 MB.\r | |
44 | \r | |
45 | **/\r | |
46 | EFI_STATUS\r | |
47 | EFIAPI\r | |
48 | S3Ready (\r | |
49 | IN EFI_ACPI_S3_SAVE_PROTOCOL *This,\r | |
0a6f4824 | 50 | IN VOID *LegacyMemoryAddress\r |
13d4af68 | 51 | );\r |
52 | #endif\r |