2 This protocol is used to store or record various boot scripts into boot
5 Copyright (c) 2007, Intel Corporation
6 All rights reserved. This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at
9 http://opensource.org/licenses/bsd-license.php
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
14 @par Revision Reference:
15 This protocol defined in the Boot Script Specification, Version 0.91.
19 #ifndef _BOOT_SCRIPT_SAVE_PROTOCOL_H_
20 #define _BOOT_SCRIPT_SAVE_PROTOCOL_H_
24 // To get the multiple phase definitions defined in Boot Script Specification
26 #include <Ppi/BootScriptExecuter.h>
29 // S3 Save Protocol GUID
31 #define EFI_BOOT_SCRIPT_SAVE_PROTOCOL_GUID \
33 0x470e1529, 0xb79e, 0x4e32, {0xa0, 0xfe, 0x6a, 0x15, 0x6d, 0x29, 0xf9, 0xb2 } \
36 typedef struct _EFI_BOOT_SCRIPT_SAVE_PROTOCOL EFI_BOOT_SCRIPT_SAVE_PROTOCOL
;
39 // Protocol Member_Function
42 Adds a record into a specified Framework boot script table.
44 @param This A pointer to the EFI_BOOT_SCRIPT_SAVE_PROTOCOL instance.
45 @param TableName Name of the script table.Currently, the only meaningful
46 value is EFI_ACPI_S3_RESUME_SCRIPT_TABLE.
47 @param OpCode The operation code (opcode) number.
48 @param ... Argument list that is specific to each opcode.
50 @retval EFI_SUCCESS The operation succeeded. A record was added into the specified script table.
51 @retval EFI_INVALID_PARAMETER The parameter is illegal or the given boot script is not supported.
52 @retval EFI_OUT_OF_RESOURCES There is insufficient memory to store the boot script.
57 (EFIAPI
*EFI_BOOT_SCRIPT_WRITE
)(
58 IN EFI_BOOT_SCRIPT_SAVE_PROTOCOL
*This
,
65 Closes the specified script table.
67 @param This A pointer to the EFI_BOOT_SCRIPT_SAVE_PROTOCOL instance.
68 @param TableName Name of the script table.
69 @param Address A pointer to the physical address where the table begins.
71 @retval EFI_SUCCESS The table was successfully returned.
72 @retval EFI_NOT_FOUND The specified table was not created previously.
73 @retval EFI_OUT_OF_RESOURCES Memory is insufficient to hold the reorganized boot script table.
78 (EFIAPI
*EFI_BOOT_SCRIPT_CLOSE_TABLE
)(
79 IN EFI_BOOT_SCRIPT_SAVE_PROTOCOL
*This
,
81 OUT EFI_PHYSICAL_ADDRESS
*Address
85 // S3 Save Protocol data structure
88 @par Protocol Description:
89 The EFI_BOOT_SCRIPT_SAVE_PROTOCOL publishes the Framework boot script abstractions
90 to store or record various boot scripts into boot script tables.
93 Writes various boot scripts to a boot script table.
96 Retrieves and closes a script table.
99 struct _EFI_BOOT_SCRIPT_SAVE_PROTOCOL
{
100 EFI_BOOT_SCRIPT_WRITE Write
;
101 EFI_BOOT_SCRIPT_CLOSE_TABLE CloseTable
;
104 extern EFI_GUID gEfiBootScriptSaveProtocolGuid
;