X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=MdePkg%2FInclude%2FPpi%2FDecompress.h;h=efd787c3f22094e0cf341f2bfc214e847ef573c0;hb=19fd6450a325ab8803d80fd147908b2b95be1c13;hp=21ef964c597df729ab079dd7c9d98ed98ee8d7be;hpb=5879b8754ac3c2e7a141bac79f6b2391e6ac0441;p=mirror_edk2.git diff --git a/MdePkg/Include/Ppi/Decompress.h b/MdePkg/Include/Ppi/Decompress.h index 21ef964c59..efd787c3f2 100644 --- a/MdePkg/Include/Ppi/Decompress.h +++ b/MdePkg/Include/Ppi/Decompress.h @@ -1,7 +1,7 @@ -/* @file +/** @file Provides decompression services to the PEI Foundatoin. - Copyright (c) 2006, Intel Corporation + Copyright (c) 2006 - 2008, Intel Corporation All rights reserved. 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 @@ -10,8 +10,6 @@ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. - Module Name: Decompress.h - @par Revision Reference: This PPI is defined in PI Version 1.00. @@ -21,60 +19,56 @@ #define __DECOMPRESS_PPI_H__ #define EFI_PEI_DECOMPRESS_PPI_GUID \ - { 0x1a36e4e7, 0xfab6, 0x476a, { 0x8e, 0x75, 0x69, 0x5a, 0x5, 0x76, 0xfd, 0xd7 } } + { 0x1a36e4e7, 0xfab6, 0x476a, { 0x8e, 0x75, 0x69, 0x5a, 0x5, 0x76, 0xfd, 0xd7 } } -typedef struct _EFI_PEI_DECOMPRESS_PPI EFI_PEI_DECOMPRESS_PPI;; +typedef struct _EFI_PEI_DECOMPRESS_PPI EFI_PEI_DECOMPRESS_PPI; -/** +/** + Decompress a single compression section in a firmware file. + Decompresses the data in a compressed section and returns it as a series of standard PI Firmware File Sections. The required memory is allocated from permanent memory. - @param This Points to this instance of the - EFI_PEI_DECOMPRESS_PEI PPI. InputSection Points to - the compressed section. - - @param OutputBuffer Holds the returned pointer to the - decompressed sections. - - @param OutputSize Holds the returned size of the decompress - section streams. - - @retval EFI_SUCCESS The section was decompressed - successfully. OutputBuffer contains the - resulting data and OutputSize contains - the resulting size. - - @retval EFI_OUT_OF_RESOURCES Unable to allocate sufficient + @param This Points to this instance of the + EFI_PEI_DECOMPRESS_PEI PPI. + @param InputSection Points to the compressed section. + @param OutputBuffer Holds the returned pointer to the + decompressed sections. + @param OutputSize Holds the returned size of the decompress + section streams. + + @retval EFI_SUCCESS The section was decompressed + successfully. OutputBuffer contains the + resulting data and OutputSize contains + the resulting size. + @retval EFI_OUT_OF_RESOURCES Unable to allocate sufficient memory to hold the decompressed data. + @retval EFI_UNSUPPORTED The compression type specified + in the compression header is unsupported. - @retval EFI_UNSUPPORTED The compression type specified - in the compression header is unsupported. **/ typedef EFI_STATUS (EFIAPI *EFI_PEI_DECOMPRESS_DECOMPRESS)( - IN CONST EFI_PEI_DECOMPRESS_PPI *This, - IN CONST EFI_COMPRESSION_SECTION *InputSection, - OUT VOID **OutputBuffer, - OUT UINTN *OutputSize + IN CONST EFI_PEI_DECOMPRESS_PPI *This, + IN CONST EFI_COMPRESSION_SECTION *InputSection, + OUT VOID **OutputBuffer, + OUT UINTN *OutputSize ); -/** - This PPI¡¯s single member function decompresses a compression - encapsulated section. It is used by the PEI Foundation to - process sectioned files. Prior to the installation of this PPI, - compression sections will be ignored. - - @param Decompress Decompress a single compression section in - a firmware file. -**/ +/// +/// This PPI's single member function decompresses a compression +/// encapsulated section. It is used by the PEI Foundation to +/// process sectioned files. Prior to the installation of this PPI, +/// compression sections will be ignored. +/// struct _EFI_PEI_DECOMPRESS_PPI { - EFI_PEI_DECOMPRESS_DECOMPRESS Decompress; + EFI_PEI_DECOMPRESS_DECOMPRESS Decompress; }; -extern EFI_GUID gEfiPeiDecompressPpiGuid; +extern EFI_GUID gEfiPeiDecompressPpiGuid; #endif