diff options
Diffstat (limited to 'MdePkg/Include/Protocol/AcpiTable.h')
| -rw-r--r-- | MdePkg/Include/Protocol/AcpiTable.h | 51 |
1 files changed, 24 insertions, 27 deletions
diff --git a/MdePkg/Include/Protocol/AcpiTable.h b/MdePkg/Include/Protocol/AcpiTable.h index c6081823268b..a428ea1b9db4 100644 --- a/MdePkg/Include/Protocol/AcpiTable.h +++ b/MdePkg/Include/Protocol/AcpiTable.h @@ -1,15 +1,12 @@ /** @file The file provides the protocol to install or remove an ACPI - table from a platform. - - Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR> - This program and the accompanying materials - are licensed and made available under the terms and conditions of the BSD License - which accompanies this distribution. The full text of the license may be found at - http://opensource.org/licenses/bsd-license.php + table from a platform. - THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, - WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR> + SPDX-License-Identifier: BSD-2-Clause-Patent + + @par Revision Reference: + This Protocol was introduced in UEFI Specification 2.3. **/ @@ -24,24 +21,24 @@ typedef struct _EFI_ACPI_TABLE_PROTOCOL EFI_ACPI_TABLE_PROTOCOL; /** - The InstallAcpiTable() function allows a caller to install an - ACPI table. When successful, the table will be linked by the - RSDT/XSDT. AcpiTableBuffer specifies the table to be installed. - InstallAcpiTable() will make a copy of the table and insert the - copy into the RSDT/XSDT. InstallAcpiTable() must insert the new - table at the end of the RSDT/XSDT. To prevent namespace - collision, ACPI tables may be created using UEFI ACPI table + The InstallAcpiTable() function allows a caller to install an + ACPI table. When successful, the table will be linked by the + RSDT/XSDT. AcpiTableBuffer specifies the table to be installed. + InstallAcpiTable() will make a copy of the table and insert the + copy into the RSDT/XSDT. InstallAcpiTable() must insert the new + table at the end of the RSDT/XSDT. To prevent namespace + collision, ACPI tables may be created using UEFI ACPI table format. If this protocol is used to install a table with a signature already present in the system, the new table will not replace the existing table. It is a platform implementation decision to add a new table with a signature matching an existing table or disallow duplicate table signatures and - return EFI_ACCESS_DENIED. On successful output, TableKey is - initialized with a unique key. Its value may be used in a - subsequent call to UninstallAcpiTable to remove an ACPI table. - If an EFI application is running at the time of this call, the - relevant EFI_CONFIGURATION_TABLE pointer to the RSDT is no - longer considered valid. + return EFI_ACCESS_DENIED. On successful output, TableKey is + initialized with a unique key. Its value may be used in a + subsequent call to UninstallAcpiTable to remove an ACPI table. + If an EFI application is running at the time of this call, the + relevant EFI_CONFIGURATION_TABLE pointer to the RSDT is no + longer considered valid. @param This A pointer to a EFI_ACPI_TABLE_PROTOCOL. @@ -54,16 +51,16 @@ typedef struct _EFI_ACPI_TABLE_PROTOCOL EFI_ACPI_TABLE_PROTOCOL; @param TableKey Returns a key to refer to the ACPI table. - + @retval EFI_SUCCESS The table was successfully inserted - + @retval EFI_INVALID_PARAMETER Either AcpiTableBuffer is NULL, TableKey is NULL, or AcpiTableBufferSize and the size field embedded in the ACPI table pointed to by AcpiTableBuffer are not in sync. - + @retval EFI_OUT_OF_RESOURCES Insufficient resources exist to complete the request. @retval EFI_ACCESS_DENIED The table signature matches a table already @@ -82,7 +79,7 @@ EFI_STATUS /** - + The UninstallAcpiTable() function allows a caller to remove an ACPI table. The routine will remove its reference from the RSDT/XSDT. A table is referenced by the TableKey parameter @@ -103,7 +100,7 @@ EFI_STATUS @retval EFI_OUT_OF_RESOURCES Insufficient resources exist to complete the request. - + **/ typedef EFI_STATUS |