1) Sync EdkCompatibilityPkg with EDK 1.04. The changes includes:

[mirror_edk2.git] / EdkCompatibilityPkg / Foundation / Framework / Protocol / AcpiSupport / AcpiSupport.h

/*++\r
\r
Copyright (c) 1999 - 2007, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
\r
Module Name:\r
\r
  AcpiSupport.h\r
\r
Abstract:\r
\r
  Definition of the ACPI Support protocol.  This is defined in the \r
  Tiano ACPI External Product Specification, revision 0.5.1.\r
\r
--*/\r
\r
#ifndef _ACPI_SUPPORT_PROTOCOL_H_\r
#define _ACPI_SUPPORT_PROTOCOL_H_\r
\r
//\r
// Includes\r
//\r
#include "Tiano.h"\r
\r
//\r
// Forward reference for pure ANSI compatability\r
//\r
EFI_FORWARD_DECLARATION (EFI_ACPI_SUPPORT_PROTOCOL);\r
\r
//\r
// ACPI Support Protocol GUID\r
//\r
#define EFI_ACPI_SUPPORT_GUID \\r
  { \\r
    0xdbff9d55, 0x89b7, 0x46da, 0xbd, 0xdf, 0x67, 0x7d, 0x3d, 0xc0, 0x24, 0x1d \\r
  }\r
\r
//\r
// Extern the GUID for protocol users.\r
//\r
extern EFI_GUID gEfiAcpiSupportGuid;\r
\r
//\r
// Protocol Data Definitions\r
//\r
//\r
// ACPI Version bitmap definition:\r
//\r
// EFI_ACPI_TABLE_VERSION_1_0B - ACPI Version 1.0b\r
// EFI_ACPI_TABLE_VERSION_2_0 - ACPI Version 2.0\r
// EFI_ACPI_TABLE_VERSION_3_0 - ACPI Version 3.0\r
// EFI_ACPI_TABLE_VERSION_NONE - No ACPI Versions.  This might be used\r
//  to create memory-based operation regions or other information\r
//  that is not part of the ACPI "tree" but must still be found\r
//  in ACPI memory space and/or managed by the core ACPI driver.\r
//\r
// Note that EFI provides discrete GUIDs for each version of ACPI\r
// that is supported.  It is expected that each EFI GUIDed\r
// version of ACPI will also have a corresponding bitmap\r
// definition.  This allows maintenance of separate ACPI trees\r
// for each distinctly different version of ACPI.\r
//\r
#define EFI_ACPI_TABLE_VERSION      UINT32\r
\r
#define EFI_ACPI_TABLE_VERSION_NONE (1 << 0)\r
#define EFI_ACPI_TABLE_VERSION_1_0B (1 << 1)\r
#define EFI_ACPI_TABLE_VERSION_2_0  (1 << 2)\r
#define EFI_ACPI_TABLE_VERSION_3_0  (1 << 3)\r
\r
//\r
// Protocol Member Functions\r
//\r
//\r
// Retrieve a copy of an ACPI table and the handle of the table.\r
//\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ACPI_GET_ACPI_TABLE) (\r
  IN EFI_ACPI_SUPPORT_PROTOCOL            * This,\r
  IN INTN                                 Index,\r
  OUT VOID                                **Table,\r
  OUT EFI_ACPI_TABLE_VERSION              * Version,\r
  OUT UINTN                               *Handle\r
  );\r
\r
//\r
// Add, update, or remove a table.\r
//\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ACPI_SET_ACPI_TABLE) (\r
  IN EFI_ACPI_SUPPORT_PROTOCOL            * This,\r
  IN VOID                                 *Table OPTIONAL,\r
  IN BOOLEAN                              Checksum,\r
  IN EFI_ACPI_TABLE_VERSION               Version,\r
  IN OUT UINTN                            *Handle\r
  );\r
\r
//\r
// Publish tables to the outside world\r
//\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ACPI_PUBLISH_TABLES) (\r
  IN EFI_ACPI_SUPPORT_PROTOCOL            * This,\r
  IN EFI_ACPI_TABLE_VERSION               Version\r
  );\r
\r
//\r
// ACPI Support Protocol\r
//\r
typedef struct _EFI_ACPI_SUPPORT_PROTOCOL {\r
  EFI_ACPI_GET_ACPI_TABLE GetAcpiTable;\r
  EFI_ACPI_SET_ACPI_TABLE SetAcpiTable;\r
  EFI_ACPI_PUBLISH_TABLES PublishTables;\r
} EFI_ACPI_SUPPORT_PROTOCOL;\r
\r
#endif\r