]> git.proxmox.com Git - mirror_edk2.git/blobdiff - DuetPkg/EfiLdr/LzmaDecompress.h
CryptoPkg/OpensslLib AARCH64: disable rather than demote format warning
[mirror_edk2.git] / DuetPkg / EfiLdr / LzmaDecompress.h
index fbf645e9874ef4a63fa1a340dc9919ab793fca6b..e244df7aaa5f1d64a16b40b914d34b4f25f2e3b7 100644 (file)
@@ -1,8 +1,8 @@
 /** @file\r
   LZMA Decompress Library header file\r
 \r
-  Copyright (c) 2006 - 2009, Intel Corporation<BR>\r
-  All rights reserved. This program and the accompanying materials\r
+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>\r
+  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
@@ -23,7 +23,7 @@
   @param DestinationSize  The size of destination buffer.\r
   @param ScratchSize      The size of scratch buffer.\r
 \r
-  @retval RETURN_SUCCESS           - The size of destination buffer and the size of scratch buffer are successull retrieved.\r
+  @retval RETURN_SUCCESS           - The size of destination buffer and the size of scratch buffer are successfully retrieved.\r
   @retval RETURN_INVALID_PARAMETER - The source data is corrupted\r
 **/\r
 RETURN_STATUS\r
@@ -36,22 +36,35 @@ LzmaUefiDecompressGetInfo (
   );\r
 \r
 /**\r
-  The internal implementation of *_DECOMPRESS_PROTOCOL.Decompress().\r
-  \r
-  @param Source          - The source buffer containing the compressed data.\r
-  @param Destination     - The destination buffer to store the decompressed data\r
-  @param Scratch         - The buffer used internally by the decompress routine. This  buffer is needed to store intermediate data.\r
+  Decompresses a Lzma compressed source buffer.\r
+\r
+  Extracts decompressed data to its original form.\r
+  If the compressed source data specified by Source is successfully decompressed \r
+  into Destination, then RETURN_SUCCESS is returned.  If the compressed source data \r
+  specified by Source is not in a valid compressed data format,\r
+  then RETURN_INVALID_PARAMETER is returned.\r
 \r
-  @retval RETURN_SUCCESS           - Decompression is successfull\r
-  @retval RETURN_INVALID_PARAMETER - The source data is corrupted  \r
+  @param  Source      The source buffer containing the compressed data.\r
+  @param  SourceSize  The size of source buffer.\r
+  @param  Destination The destination buffer to store the decompressed data\r
+  @param  Scratch     A temporary scratch buffer that is used to perform the decompression.\r
+                      This is an optional parameter that may be NULL if the \r
+                      required scratch buffer size is 0.\r
+                     \r
+  @retval  RETURN_SUCCESS Decompression completed successfully, and \r
+                          the uncompressed buffer is returned in Destination.\r
+  @retval  RETURN_INVALID_PARAMETER \r
+                          The source buffer specified by Source is corrupted \r
+                          (not in a valid compressed format).\r
 **/\r
 RETURN_STATUS\r
 EFIAPI\r
 LzmaUefiDecompress (\r
   IN CONST VOID  *Source,\r
+  IN UINTN       SourceSize,\r
   IN OUT VOID    *Destination,\r
   IN OUT VOID    *Scratch\r
   );\r
-\r
+  \r
 #endif // __LZMADECOMPRESS_H__\r
 \r