IntelFrameworkPkg/Include/Protocol/BootScriptSave.h

   1 /** @file
   2   This protocol is used to store or record various boot scripts into boot
   3   script tables.
   4
   5   Copyright (c) 2007 - 2009, 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
  10
  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.
  13
  14   @par Revision Reference:
  15   This protocol defined in the Boot Script Specification, Version 0.91.
  16
  17 **/
  18
  19 #ifndef _BOOT_SCRIPT_SAVE_PROTOCOL_H_
  20 #define _BOOT_SCRIPT_SAVE_PROTOCOL_H_
  21
  22 #include <PiDxe.h>
  23 //
  24 // To get the multiple phase definitions defined in Boot Script Specification
  25 //
  26 #include <Ppi/BootScriptExecuter.h>
  27
  28 //
  29 // S3 Save Protocol GUID
  30 //
  31 #define EFI_BOOT_SCRIPT_SAVE_PROTOCOL_GUID \
  32   { \
  33     0x470e1529, 0xb79e, 0x4e32, {0xa0, 0xfe, 0x6a, 0x15, 0x6d, 0x29, 0xf9, 0xb2 } \
  34   }
  35
  36 typedef struct _EFI_BOOT_SCRIPT_SAVE_PROTOCOL EFI_BOOT_SCRIPT_SAVE_PROTOCOL;
  37
  38 //
  39 // Protocol Member_Function
  40 //
  41 /**
  42   Adds a record into a specified Framework boot script table.
  43
  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.
  49
  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.
  53
  54 **/
  55 typedef
  56 EFI_STATUS
  57 (EFIAPI *EFI_BOOT_SCRIPT_WRITE)(
  58   IN EFI_BOOT_SCRIPT_SAVE_PROTOCOL            *This,
  59   IN UINT16                                   TableName,
  60   IN UINT16                                   OpCode,
  61   ...
  62   );
  63
  64 /**
  65   Closes the specified script table.
  66
  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.
  70
  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.
  74
  75 **/
  76 typedef
  77 EFI_STATUS
  78 (EFIAPI *EFI_BOOT_SCRIPT_CLOSE_TABLE)(
  79   IN EFI_BOOT_SCRIPT_SAVE_PROTOCOL            *This,
  80   IN UINT16                                   TableName,
  81   OUT EFI_PHYSICAL_ADDRESS                    *Address
  82   );
  83
  84 //
  85 // S3 Save Protocol data structure
  86 //
  87 /**
  88   The EFI_BOOT_SCRIPT_SAVE_PROTOCOL publishes the Framework boot script abstractions
  89   to store or record various boot scripts into boot script tables.
  90 **/
  91 struct _EFI_BOOT_SCRIPT_SAVE_PROTOCOL {
  92   EFI_BOOT_SCRIPT_WRITE       Write;      ///< Writes various boot scripts to a boot script table.
  93   EFI_BOOT_SCRIPT_CLOSE_TABLE CloseTable; ///< Retrieves and closes a script table.
  94 };
  95
  96 extern EFI_GUID gEfiBootScriptSaveProtocolGuid;
  97
  98 #endif
  99