Make variable names for protocol GUIDs consistent
[mirror_edk2.git] / MdePkg / Include / Protocol / AcpiSupport.h
CommitLineData
878ddf1f 1/** @file\r
2 Definition of the ACPI Support protocol.\r
3\r
4 Copyright (c) 2006, Intel Corporation \r
5 All rights reserved. This program and the accompanying materials \r
6 are licensed and made available under the terms and conditions of the BSD License \r
7 which accompanies this distribution. The full text of the license may be found at \r
8 http://opensource.org/licenses/bsd-license.php \r
9\r
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
12\r
13 Module Name: AcpiSupport.h\r
14\r
15 @par Revision Reference:\r
16 This is defined in the ACPI Specification 0.9.\r
17 \r
18**/\r
19\r
20#ifndef _ACPI_SUPPORT_PROTOCOL_H_\r
21#define _ACPI_SUPPORT_PROTOCOL_H_\r
22\r
23typedef struct _EFI_ACPI_SUPPORT_PROTOCOL EFI_ACPI_SUPPORT_PROTOCOL;\r
24\r
25//\r
26// ACPI Support Protocol GUID\r
27//\r
28#define EFI_ACPI_SUPPORT_GUID \\r
29 { \\r
30 0xdbff9d55, 0x89b7, 0x46da, {0xbd, 0xdf, 0x67, 0x7d, 0x3d, 0xc0, 0x24, 0x1d } \\r
31 }\r
32\r
33//\r
34// Protocol Data Definitions\r
35//\r
36//\r
37// ACPI Version bitmap definition:\r
38//\r
39// EFI_ACPI_TABLE_VERSION_1_0B - ACPI Version 1.0b\r
40// EFI_ACPI_TABLE_VERSION_2_0 - ACPI Version 2.0\r
41// EFI_ACPI_TABLE_VERSION_3_0 - ACPI Version 3.0\r
42// EFI_ACPI_TABLE_VERSION_NONE - No ACPI Versions. This might be used\r
43// to create memory-based operation regions or other information\r
44// that is not part of the ACPI "tree" but must still be found\r
45// in ACPI memory space and/or managed by the core ACPI driver.\r
46//\r
47// Note that EFI provides discrete GUIDs for each version of ACPI\r
48// that is supported. It is expected that each EFI GUIDed\r
49// version of ACPI will also have a corresponding bitmap\r
50// definition. This allows maintenance of separate ACPI trees\r
51// for each distinctly different version of ACPI.\r
52//\r
53#define EFI_ACPI_TABLE_VERSION UINT32\r
54\r
55#define EFI_ACPI_TABLE_VERSION_NONE (1 << 0)\r
56#define EFI_ACPI_TABLE_VERSION_1_0B (1 << 1)\r
57#define EFI_ACPI_TABLE_VERSION_2_0 (1 << 2)\r
58#define EFI_ACPI_TABLE_VERSION_3_0 (1 << 3)\r
59\r
60//\r
61// Protocol Member Functions\r
62//\r
63\r
64/**\r
65 Returns a requested ACPI table.\r
66\r
67 @param This A pointer to the EFI_ACPI_SUPPORT_PROTOCOL instance.\r
68 \r
69 @param Index The zero-based index of the table to retrieve.\r
70 \r
71 @param Table Pointer for returning the table buffer.\r
72 \r
73 @param Version Updated with the ACPI versions to which this table belongs.\r
74 \r
75 @param Handle Pointer for identifying the table.\r
76\r
77 @retval EFI_SUCCESS The function completed successfully.\r
78 \r
79 @retval EFI_NOT_FOUND The requested index is too large and a table was not found.\r
80\r
81**/\r
82typedef\r
83EFI_STATUS\r
84(EFIAPI *EFI_ACPI_GET_ACPI_TABLE) (\r
85 IN EFI_ACPI_SUPPORT_PROTOCOL *This,\r
86 IN INTN Index,\r
87 OUT VOID **Table,\r
88 OUT EFI_ACPI_TABLE_VERSION *Version,\r
89 OUT UINTN *Handle\r
90 );\r
91\r
92/**\r
93 Used to add, remove, or update ACPI tables.\r
94\r
95 @param This A pointer to the EFI_ACPI_SUPPORT_PROTOCOL instance.\r
96 \r
97 @param Table Pointer to the new table to add or update.\r
98 \r
99 @param Checksum If TRUE, indicates that the checksum should be \r
100 calculated for this table.\r
101 \r
102 @param Version Indicates to which version(s) of ACPI the table should be added.\r
103 \r
104 @param Pointer to the handle of the table to remove or update.\r
105\r
106 @retval EFI_SUCCESS The function completed successfully.\r
107 \r
108 @retval EFI_INVALID_PARAMETER *Handle was zero and Table was NULL.\r
109 \r
110 @retval EFI_ABORTED Could not complete the desired action.\r
111\r
112**/\r
113typedef\r
114EFI_STATUS\r
115(EFIAPI *EFI_ACPI_SET_ACPI_TABLE) (\r
116 IN EFI_ACPI_SUPPORT_PROTOCOL *This,\r
117 IN VOID *Table OPTIONAL,\r
118 IN BOOLEAN Checksum,\r
119 IN EFI_ACPI_TABLE_VERSION Version,\r
120 IN OUT UINTN *Handle\r
121 );\r
122\r
123/**\r
124 Causes one or more versions of the ACPI tables to be published in \r
125 the EFI system configuration tables.\r
126\r
127 @param This A pointer to the EFI_ACPI_SUPPORT_PROTOCOL instance.\r
128 \r
129 @param Version Indicates to which version(s) of ACPI that the table should be published. \r
130\r
131 @retval EFI_SUCCESS The function completed successfully.\r
132 \r
133 @retval EFI_ABORTED An error occurred and the function could not complete successfully.\r
134\r
135**/\r
136typedef\r
137EFI_STATUS\r
138(EFIAPI *EFI_ACPI_PUBLISH_TABLES) (\r
139 IN EFI_ACPI_SUPPORT_PROTOCOL *This,\r
140 IN EFI_ACPI_TABLE_VERSION Version\r
141 );\r
142\r
143//\r
144// ACPI Support Protocol\r
145//\r
146/**\r
147 @par Protocol Description:\r
148 This protocol provides some basic services to support publishing ACPI system \r
149 tables. The services handle many of the more mundane tasks that are required \r
150 to publish a set of tables. \r
151\r
152 @param GetAcpiTable\r
153 Returns a table specified by an index if it exists.\r
154\r
155 @param SetAcpiTable\r
156 Adds, removes, or updates ACPI tables\r
157\r
158 @param PublishTables\r
159 Publishes the ACPI tables.\r
160\r
161**/\r
162struct _EFI_ACPI_SUPPORT_PROTOCOL {\r
163 EFI_ACPI_GET_ACPI_TABLE GetAcpiTable;\r
164 EFI_ACPI_SET_ACPI_TABLE SetAcpiTable;\r
165 EFI_ACPI_PUBLISH_TABLES PublishTables;\r
166};\r
167\r
168//\r
169// Extern the GUID for protocol users.\r
170//\r
f15e4e27 171extern EFI_GUID gEfiAcpiSupportProtocolGuid;\r
878ddf1f 172\r
173#endif\r