Adjust coding style for MemoryAllocationLib.
authorqhuang8 <qhuang8@6f19259b-4bc3-4df7-8a09-765794883524>
Sun, 23 Jul 2006 12:55:05 +0000 (12:55 +0000)
committerqhuang8 <qhuang8@6f19259b-4bc3-4df7-8a09-765794883524>
Sun, 23 Jul 2006 12:55:05 +0000 (12:55 +0000)
Add function header for an internal function of PciExpressLib
Fix a typo in one comment of UefiLib
Remove BaseSmbusLib

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@1075 6f19259b-4bc3-4df7-8a09-765794883524

MdePkg/Include/Library/MemoryAllocationLib.h
MdePkg/Library/BasePciExpressLib/PciLib.c
MdePkg/Library/DxeMemoryAllocationLib/MemoryAllocationLib.c
MdePkg/Library/PeiMemoryAllocationLib/MemoryAllocationLib.c
MdePkg/Library/UefiLib/UefiNotTiano.c
MdePkg/MdePkg.fpd
MdePkg/MdePkg.spd

index bb2c724..d8bbe38 100644 (file)
 #define __MEMORY_ALLOCATION_LIB_H__\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData.\r
+  Allocates one or more 4KB pages of type EfiBootServicesData.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.\r
-  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocatePages (\r
   IN UINTN  Pages\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData. \r
+  Allocates one or more 4KB pages of type EfiRuntimeServicesData.\r
+\r
+  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.\r
-  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocateRuntimePages (\r
   IN UINTN  Pages\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType. \r
+  Allocates one or more 4KB pages of type EfiReservedMemoryType.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.\r
-  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocateReservedPages (\r
   IN UINTN  Pages\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Frees one or more 4KB pages that were previously allocated with \r
-  one of the page allocation functions in the Memory Allocation Library.\r
-\r
-  @param  Buffer Pointer to the buffer of pages to free.\r
-  @param  Pages The number of 4 KB pages to free.\r
-\r
-  None.\r
+  Frees one or more 4KB pages that were previously allocated with one of the page allocation\r
+  functions in the Memory Allocation Library.\r
+\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer\r
+  must have been allocated on a previous call to the page allocation services of the Memory\r
+  Allocation Library.\r
+  If Buffer was not allocated with a page allocation function in the Memory Allocation Library,\r
+  then ASSERT().\r
+  If Pages is zero, then ASSERT().\r
\r
+  @param  Buffer                Pointer to the buffer of pages to free.\r
+  @param  Pages                 The number of 4 KB pages to free.\r
 \r
 **/\r
 VOID\r
@@ -86,19 +94,22 @@ EFIAPI
 FreePages (\r
   IN VOID   *Buffer,\r
   IN UINTN  Pages\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an alignment specified by Alignment.   \r
+  Allocates one or more 4KB pages of type EfiBootServicesData at a specified alignment.\r
+\r
+  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -106,19 +117,22 @@ EFIAPI
 AllocateAlignedPages (\r
   IN UINTN  Pages,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an alignment specified by Alignment.   \r
+  Allocates one or more 4KB pages of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return\r
-  The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -126,19 +140,22 @@ EFIAPI
 AllocateAlignedRuntimePages (\r
   IN UINTN  Pages,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
+\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -146,17 +163,21 @@ EFIAPI
 AllocateAlignedReservedPages (\r
   IN UINTN  Pages,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Frees one or more 4KB pages that were previously allocated with \r
-  one of the aligned page allocation functions in the Memory Allocation Library.\r
-\r
-  @param  Buffer Pointer to the buffer of pages to free.\r
-  @param  Pages The number of 4 KB pages to free.\r
-\r
-  None.\r
+  Frees one or more 4KB pages that were previously allocated with one of the aligned page\r
+  allocation functions in the Memory Allocation Library.\r
+\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer\r
+  must have been allocated on a previous call to the aligned page allocation services of the Memory\r
+  Allocation Library.\r
+  If Buffer was not allocated with an aligned page allocation function in the Memory Allocation\r
+  Library, then ASSERT().\r
+  If Pages is zero, then ASSERT().\r
+  \r
+  @param  Buffer                Pointer to the buffer of pages to free.\r
+  @param  Pages                 The number of 4 KB pages to free.\r
 \r
 **/\r
 VOID\r
@@ -164,120 +185,133 @@ EFIAPI
 FreeAlignedPages (\r
   IN VOID   *Buffer,\r
   IN UINTN  Pages\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates a buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData and returns a\r
+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocatePool (\r
   IN UINTN  AllocationSize\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates a buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData and returns\r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+\r
+  @param  AllocationSize        The number of bytes to allocate.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocateRuntimePool (\r
   IN UINTN  AllocationSize\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Allocates a buffer of type EfiReservedMemoryType.\r
+  Allocates a buffer of type EfieservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType and returns\r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocateReservedPool (\r
   IN UINTN  AllocationSize\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates and zeros a buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
+\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocateZeroPool (\r
   IN UINTN  AllocationSize\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates and zeros a buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
+\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocateRuntimeZeroPool (\r
   IN UINTN  AllocationSize\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates and zeros a buffer of type EfiReservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
 AllocateReservedZeroPool (\r
   IN UINTN  AllocationSize\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiBootServicesData. \r
+  Copies a buffer to an allocated buffer of type EfiBootServicesData.\r
+\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -285,18 +319,22 @@ EFIAPI
 AllocateCopyPool (\r
   IN UINTN       AllocationSize,\r
   IN CONST VOID  *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData. \r
+  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -304,18 +342,22 @@ EFIAPI
 AllocateRuntimeCopyPool (\r
   IN UINTN       AllocationSize,\r
   IN CONST VOID  *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiReservedMemoryType. \r
+  Copies a buffer to an allocated buffer of type EfiReservedMemoryType.\r
+\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -323,35 +365,40 @@ EFIAPI
 AllocateReservedCopyPool (\r
   IN UINTN       AllocationSize,\r
   IN CONST VOID  *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Frees a buffer that was previously allocated with one of the pool allocation functions \r
-  in the Memory Allocation Library.\r
+  Frees a buffer that was previously allocated with one of the pool allocation functions in the\r
+  Memory Allocation Library.\r
 \r
-  @param  Buffer Pointer to the buffer to free.\r
+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the\r
+  pool allocation services of the Memory Allocation Library.\r
+  If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,\r
+  then ASSERT().\r
 \r
-  None.\r
+  @param  Buffer                Pointer to the buffer to free.\r
 \r
 **/\r
 VOID\r
 EFIAPI\r
 FreePool (\r
   IN VOID   *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates a buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-    If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
+\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -359,19 +406,22 @@ EFIAPI
 AllocateAlignedPool (\r
   IN UINTN  AllocationSize,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates a buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
+\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -379,19 +429,22 @@ EFIAPI
 AllocateAlignedRuntimePool (\r
   IN UINTN  AllocationSize,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Allocates a buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Allocates a buffer of type EfieservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -399,19 +452,23 @@ EFIAPI
 AllocateAlignedReservedPool (\r
   IN UINTN  AllocationSize,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates and zeros a buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
+\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -419,19 +476,23 @@ EFIAPI
 AllocateAlignedZeroPool (\r
   IN UINTN  AllocationSize,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Allocates and zeros a buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -439,19 +500,23 @@ EFIAPI
 AllocateAlignedRuntimeZeroPool (\r
   IN UINTN  AllocationSize,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
-  Allocates and zeros a buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Allocates and zeros a buffer of type EfieservedMemoryType at a specified alignment.\r
+\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -459,20 +524,23 @@ EFIAPI
 AllocateAlignedReservedZeroPool (\r
   IN UINTN  AllocationSize,\r
   IN UINTN  Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Copies a buffer to an allocated buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -481,20 +549,23 @@ AllocateAlignedCopyPool (
   IN UINTN       AllocationSize,\r
   IN CONST VOID  *Buffer,\r
   IN UINTN       Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Copies a buffer to an allocated buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
+\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -503,20 +574,23 @@ AllocateAlignedRuntimeCopyPool (
   IN UINTN       AllocationSize,\r
   IN CONST VOID  *Buffer,\r
   IN UINTN       Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Copies a buffer to an allocated buffer of type EfiReservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
+\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return\r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -525,23 +599,24 @@ AllocateAlignedReservedCopyPool (
   IN UINTN       AllocationSize,\r
   IN CONST VOID  *Buffer,\r
   IN UINTN       Alignment\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Frees a buffer that was previously allocated with one of the aligned pool allocation functions \r
   in the Memory Allocation Library.\r
 \r
-  @param  Buffer Pointer to the buffer to free.\r
+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the\r
+  aligned pool allocation services of the Memory Allocation Library.\r
+  If Buffer was not allocated with an aligned pool allocation function in the Memory Allocation\r
+  Library, then ASSERT().\r
 \r
-  None.\r
+  @param  Buffer                Pointer to the buffer to free.\r
 \r
 **/\r
 VOID\r
 EFIAPI\r
 FreeAlignedPool (\r
   IN VOID   *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 #endif\r
index 771c18f..509a5e4 100644 (file)
   ASSERT (((A) & ~0xfffffff) == 0)\r
 \r
 \r
+/**\r
+  Gets the base address of PCI Express.\r
+  \r
+  This internal functions retrieves PCI Express Base Address via a PCD entry\r
+  PcdPciExpressBaseAddress.\r
+  \r
+  @return The base address of PCI Express.\r
+\r
+**/\r
 UINTN\r
-EFIAPI\r
 GetPciExpressBaseAddress (\r
   VOID\r
   )\r
index 15a419b..36acc1a 100644 (file)
 **/\r
 \r
 \r
-\r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of a certain memory type.\r
-\r
-  @param  MemoryType The type of memory to allocate.\r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates one or more 4KB pages of a certain memory type.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.<BR>\r
-  If Pages is 0, then NULL is returned.<BR>\r
+  Allocates the number of 4KB pages of a certain memory type and returns a pointer to the allocated\r
+  buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL is returned.\r
   If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
+  @param  MemoryType            The type of memory to allocate.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
+\r
 **/\r
 VOID *\r
 InternalAllocatePages (\r
@@ -48,13 +49,16 @@ InternalAllocatePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData.\r
+  Allocates one or more 4KB pages of type EfiBootServicesData.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.<BR>\r
-  If Pages is 0, then NULL is returned.<BR>\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -67,13 +71,16 @@ AllocatePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData. \r
+  Allocates one or more 4KB pages of type EfiRuntimeServicesData.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.<BR>\r
-  If Pages is 0, then NULL is returned.<BR>\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -86,13 +93,16 @@ AllocateRuntimePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType. \r
+  Allocates one or more 4KB pages of type EfiReservedMemoryType.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.<BR>\r
-  If Pages is 0, then NULL is returned.<BR>\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -105,11 +115,18 @@ AllocateReservedPages (
 }\r
 \r
 /**\r
-  Frees one or more 4KB pages that were previously allocated with \r
-  one of the page allocation functions in the Memory Allocation Library.\r
-\r
-  @param  Buffer Pointer to the buffer of pages to free.\r
-  @param  Pages The number of 4 KB pages to free.\r
+  Frees one or more 4KB pages that were previously allocated with one of the page allocation\r
+  functions in the Memory Allocation Library.\r
+\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer\r
+  must have been allocated on a previous call to the page allocation services of the Memory\r
+  Allocation Library.\r
+  If Buffer was not allocated with a page allocation function in the Memory Allocation Library,\r
+  then ASSERT().\r
+  If Pages is zero, then ASSERT().\r
\r
+  @param  Buffer                Pointer to the buffer of pages to free.\r
+  @param  Pages                 The number of 4 KB pages to free.\r
 \r
 **/\r
 VOID\r
@@ -127,17 +144,20 @@ FreePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of a certian memory type \r
-  with an alignment specified by Alignment. \r
+  Allocates one or more 4KB pages of a certain memory type at a specified alignment.\r
 \r
-  @param  MemoryType The type of memory to allocate.\r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number of 4KB pages specified by Pages of a certain memory type with an alignment\r
+  specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
+  If there is not enough memory at the specified alignment remaining to satisfy the request, then\r
+  NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return The allocated buffer is returned.<BR>\r
-  If Pages is 0, then NULL is returned.<BR>\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @param  MemoryType            The type of memory to allocate.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -209,16 +229,19 @@ InternalAllocateAlignedPages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData\r
-  with an alignment specified by Alignment.   \r
+  Allocates one or more 4KB pages of type EfiBootServicesData at a specified alignment.\r
+\r
+  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return The allocated buffer is returned.<BR>\r
-  If Pages is 0, then NULL is returned.<BR>\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -232,15 +255,19 @@ AllocateAlignedPages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData\r
-  with an alignment specified by Alignment.   \r
+  Allocates one or more 4KB pages of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -256,12 +283,17 @@ AllocateAlignedRuntimePages (
 /**\r
   Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
+\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -275,11 +307,18 @@ AllocateAlignedReservedPages (
 }\r
 \r
 /**\r
-  Frees one or more 4KB pages that were previously allocated with \r
-  one of the aligned page allocation functions in the Memory Allocation Library.\r
-\r
-  @param  Buffer Pointer to the buffer of pages to free.\r
-  @param  Pages The number of 4 KB pages to free.\r
+  Frees one or more 4KB pages that were previously allocated with one of the aligned page\r
+  allocation functions in the Memory Allocation Library.\r
+\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer\r
+  must have been allocated on a previous call to the aligned page allocation services of the Memory\r
+  Allocation Library.\r
+  If Buffer was not allocated with an aligned page allocation function in the Memory Allocation\r
+  Library, then ASSERT().\r
+  If Pages is zero, then ASSERT().\r
+  \r
+  @param  Buffer                Pointer to the buffer of pages to free.\r
+  @param  Pages                 The number of 4 KB pages to free.\r
 \r
 **/\r
 VOID\r
@@ -297,13 +336,16 @@ FreeAlignedPages (
 }\r
 \r
 /**\r
-  Allocates a buffer of a certain memory type.\r
+  Allocates a buffer of a certain pool type.\r
 \r
-  @param  MemoryType The type of memory to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type and returns a\r
+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  MemoryType            The type of memory to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -325,10 +367,13 @@ InternalAllocatePool (
 /**\r
   Allocates a buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData and returns a\r
+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -343,10 +388,13 @@ AllocatePool (
 /**\r
   Allocates a buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData and returns\r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -359,12 +407,15 @@ AllocateRuntimePool (
 }\r
 \r
 /**\r
-  Allocates a buffer of type EfiReservedMemoryType.\r
+  Allocates a buffer of type EfieservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType and returns\r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -379,11 +430,15 @@ AllocateReservedPool (
 /**\r
   Allocates and zeros a buffer of a certian pool type.\r
 \r
-  @param  PoolType The type of memory to allocate.\r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of a certian pool type, clears the buffer\r
+  with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a valid\r
+  buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the request,\r
+  then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of memory to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -393,6 +448,7 @@ InternalAllocateZeroPool (
   ) \r
 {\r
   VOID  *Memory;\r
+\r
   Memory = InternalAllocatePool (PoolType, AllocationSize);\r
   if (Memory != NULL) {\r
     Memory = ZeroMem (Memory, AllocationSize);\r
@@ -403,10 +459,14 @@ InternalAllocateZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -421,10 +481,14 @@ AllocateZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -439,10 +503,14 @@ AllocateRuntimeZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiReservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -455,14 +523,20 @@ AllocateReservedZeroPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of a certian memory type. \r
+  Copies a buffer to an allocated buffer of a certian pool type.\r
 \r
-  @param  MemoryType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of a certian pool type, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -485,13 +559,19 @@ InternalAllocateCopyPool (
 } \r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiBootServicesData. \r
+  Copies a buffer to an allocated buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -505,13 +585,19 @@ AllocateCopyPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData. \r
+  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -525,13 +611,19 @@ AllocateRuntimeCopyPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiReservedMemoryType. \r
+  Copies a buffer to an allocated buffer of type EfiReservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -545,9 +637,15 @@ AllocateReservedCopyPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Frees a buffer that was previously allocated with one of the pool allocation functions in the\r
+  Memory Allocation Library.\r
+\r
+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the\r
+  pool allocation services of the Memory Allocation Library.\r
+  If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,\r
+  then ASSERT().\r
 \r
-  @param  Buffer Pointer to the buffer to free.\r
+  @param  Buffer                Pointer to the buffer to free.\r
 \r
 **/\r
 VOID\r
@@ -565,12 +663,18 @@ FreePool (
 /**\r
   Allocates a buffer of a certain pool type at a specified alignment.\r
 \r
-  @param  PoolType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.                            If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type with an alignment\r
+  specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0, then a valid\r
+  buffer of 0 size is returned.  If there is not enough memory at the specified alignment remaining\r
+  to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.                            If Alignment is zero, then byte alignment is used.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -624,11 +728,17 @@ InternalAllocateAlignedPool (
 /**\r
   Allocates a buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.                            If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -644,12 +754,17 @@ AllocateAlignedPool (
 /**\r
   Allocates a buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -663,14 +778,19 @@ AllocateAlignedRuntimePool (
 }\r
 \r
 /**\r
-  Allocates a buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Allocates a buffer of type EfieservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -684,15 +804,20 @@ AllocateAlignedReservedPool (
 }\r
 \r
 /**\r
-  Allocates and zeros a buffer of type EfiBootServicesData at a specified alignment.\r
+  Allocates and zeros a buffer of a certain pool type at a specified alignment.\r
 \r
-  @param  PoolType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type with an alignment\r
+  specified by Alignment, clears the buffer with zeros, and returns a pointer to the allocated\r
+  buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is not\r
+  enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -713,12 +838,18 @@ InternalAllocateAlignedZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -734,12 +865,18 @@ AllocateAlignedZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -753,14 +890,20 @@ AllocateAlignedRuntimeZeroPool (
 }\r
 \r
 /**\r
-  Allocates and zeros a buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Allocates and zeros a buffer of type EfieservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -774,16 +917,21 @@ AllocateAlignedReservedZeroPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiBootServicesData at a specified alignment.\r
+  Copies a buffer to an allocated buffer of a certain pool type at a specified alignment.\r
 \r
-  @param  PoolType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type with an alignment\r
+  specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0, then a valid\r
+  buffer of 0 size is returned.  If there is not enough memory at the specified alignment remaining\r
+  to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -809,13 +957,18 @@ InternalAllocateAlignedCopyPool (
 /**\r
   Copies a buffer to an allocated buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -832,13 +985,18 @@ AllocateAlignedCopyPool (
 /**\r
   Copies a buffer to an allocated buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -855,13 +1013,18 @@ AllocateAlignedRuntimeCopyPool (
 /**\r
   Copies a buffer to an allocated buffer of type EfiReservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -879,7 +1042,12 @@ AllocateAlignedReservedCopyPool (
   Frees a buffer that was previously allocated with one of the aligned pool allocation functions \r
   in the Memory Allocation Library.\r
 \r
-  @param  Buffer Pointer to the buffer to free.\r
+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the\r
+  aligned pool allocation services of the Memory Allocation Library.\r
+  If Buffer was not allocated with an aligned pool allocation function in the Memory Allocation\r
+  Library, then ASSERT().\r
+\r
+  @param  Buffer                Pointer to the buffer to free.\r
 \r
 **/\r
 VOID\r
index 59e9a26..b4f84cb 100644 (file)
 **/\r
 \r
 \r
-\r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of a certain memory type.\r
-\r
-  @param  MemoryType The type of memory to allocate.\r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates one or more 4KB pages of a certain memory type.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.\r
-  If Pages is 0, then NULL is returned.\r
+  Allocates the number of 4KB pages of a certain memory type and returns a pointer to the allocated\r
+  buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL is returned.\r
   If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
+  @param  MemoryType            The type of memory to allocate.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
+\r
 **/\r
 VOID *\r
 InternalAllocatePages (\r
@@ -50,13 +51,16 @@ InternalAllocatePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData.\r
+  Allocates one or more 4KB pages of type EfiBootServicesData.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.\r
-  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -69,13 +73,16 @@ AllocatePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData. \r
+  Allocates one or more 4KB pages of type EfiRuntimeServicesData.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.\r
-  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -88,13 +95,16 @@ AllocateRuntimePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType. \r
+  Allocates one or more 4KB pages of type EfiReservedMemoryType.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
+  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a pointer to the\r
+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL\r
+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is\r
+  returned.\r
 \r
-  @return A pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.\r
-  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -107,11 +117,18 @@ AllocateReservedPages (
 }\r
 \r
 /**\r
-  Frees one or more 4KB pages that were previously allocated with \r
-  one of the page allocation functions in the Memory Allocation Library.\r
-\r
-  @param  Buffer Pointer to the buffer of pages to free.\r
-  @param  Pages The number of 4 KB pages to free.\r
+  Frees one or more 4KB pages that were previously allocated with one of the page allocation\r
+  functions in the Memory Allocation Library.\r
+\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer\r
+  must have been allocated on a previous call to the page allocation services of the Memory\r
+  Allocation Library.\r
+  If Buffer was not allocated with a page allocation function in the Memory Allocation Library,\r
+  then ASSERT().\r
+  If Pages is zero, then ASSERT().\r
\r
+  @param  Buffer                Pointer to the buffer of pages to free.\r
+  @param  Pages                 The number of 4 KB pages to free.\r
 \r
 **/\r
 VOID\r
@@ -127,16 +144,20 @@ FreePages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of a certian memory type \r
-  with an alignment specified by Alignment. \r
+  Allocates one or more 4KB pages of a certain memory type at a specified alignment.\r
+\r
+  Allocates the number of 4KB pages specified by Pages of a certain memory type with an alignment\r
+  specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
+  If there is not enough memory at the specified alignment remaining to satisfy the request, then\r
+  NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @param  MemoryType The type of memory to allocate.\r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  @param  MemoryType            The type of memory to allocate.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -174,15 +195,19 @@ InternalAllocateAlignedPages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData\r
-  with an alignment specified by Alignment.   \r
+  Allocates one or more 4KB pages of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -196,15 +221,19 @@ AllocateAlignedPages (
 }\r
 \r
 /**\r
-  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData\r
-  with an alignment specified by Alignment.   \r
+  Allocates one or more 4KB pages of type EfiRuntimeServicesData at a specified alignment.\r
+\r
+  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
 \r
-  @return The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -220,12 +249,17 @@ AllocateAlignedRuntimePages (
 /**\r
   Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.\r
 \r
-  @param  Pages The number of 4 KB pages to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is\r
+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the\r
+  request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return The allocated buffer is returned.  If Pages is 0, then NULL is returned.\r
-  If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  @param  Pages                 The number of 4 KB pages to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -239,11 +273,18 @@ AllocateAlignedReservedPages (
 }\r
 \r
 /**\r
-  Frees one or more 4KB pages that were previously allocated with \r
-  one of the aligned page allocation functions in the Memory Allocation Library.\r
-\r
-  @param  Buffer Pointer to the buffer of pages to free.\r
-  @param  Pages The number of 4 KB pages to free.\r
+  Frees one or more 4KB pages that were previously allocated with one of the aligned page\r
+  allocation functions in the Memory Allocation Library.\r
+\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer\r
+  must have been allocated on a previous call to the aligned page allocation services of the Memory\r
+  Allocation Library.\r
+  If Buffer was not allocated with an aligned page allocation function in the Memory Allocation\r
+  Library, then ASSERT().\r
+  If Pages is zero, then ASSERT().\r
+  \r
+  @param  Buffer                Pointer to the buffer of pages to free.\r
+  @param  Pages                 The number of 4 KB pages to free.\r
 \r
 **/\r
 VOID\r
@@ -259,13 +300,16 @@ FreeAlignedPages (
 }\r
 \r
 /**\r
-  Allocates a buffer of a certain memory type.\r
+  Allocates a buffer of a certain pool type.\r
 \r
-  @param  MemoryType The type of memory to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type and returns a\r
+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  MemoryType            The type of memory to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -285,10 +329,13 @@ InternalAllocatePool (
 /**\r
   Allocates a buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData and returns a\r
+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -313,10 +360,13 @@ AllocatePool (
 /**\r
   Allocates a buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData and returns\r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -329,12 +379,15 @@ AllocateRuntimePool (
 }\r
 \r
 /**\r
-  Allocates a buffer of type EfiReservedMemoryType.\r
+  Allocates a buffer of type EfieservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType and returns\r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is\r
+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -349,11 +402,15 @@ AllocateReservedPool (
 /**\r
   Allocates and zeros a buffer of a certian pool type.\r
 \r
-  @param  PoolType The type of memory to allocate.\r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of a certian pool type, clears the buffer\r
+  with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a valid\r
+  buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the request,\r
+  then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of memory to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -374,10 +431,14 @@ InternalAllocateZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -398,10 +459,14 @@ AllocateZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -416,10 +481,14 @@ AllocateRuntimeZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiReservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, clears the\r
+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a\r
+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the\r
+  request, then NULL is returned.\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -432,14 +501,20 @@ AllocateReservedZeroPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of a certian memory type. \r
+  Copies a buffer to an allocated buffer of a certian pool type.\r
 \r
-  @param  MemoryType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate and zero.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of a certian pool type, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -462,13 +537,19 @@ InternalAllocateCopyPool (
 } \r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiBootServicesData. \r
+  Copies a buffer to an allocated buffer of type EfiBootServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -491,13 +572,19 @@ AllocateCopyPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData. \r
+  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -511,13 +598,19 @@ AllocateRuntimeCopyPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiReservedMemoryType. \r
+  Copies a buffer to an allocated buffer of type EfiReservedMemoryType.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, copies\r
+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  If Buffer is NULL, then ASSERT().\r
+  If AllocationSize is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate and zero.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -531,9 +624,15 @@ AllocateReservedCopyPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Frees a buffer that was previously allocated with one of the pool allocation functions in the\r
+  Memory Allocation Library.\r
 \r
-  @param  Buffer Pointer to the buffer to free.\r
+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the\r
+  pool allocation services of the Memory Allocation Library.\r
+  If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,\r
+  then ASSERT().\r
+\r
+  @param  Buffer                Pointer to the buffer to free.\r
 \r
 **/\r
 VOID\r
@@ -550,12 +649,18 @@ FreePool (
 /**\r
   Allocates a buffer of a certain pool type at a specified alignment.\r
 \r
-  @param  PoolType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.                            If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type with an alignment\r
+  specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0, then a valid\r
+  buffer of 0 size is returned.  If there is not enough memory at the specified alignment remaining\r
+  to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.                            If Alignment is zero, then byte alignment is used.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -594,11 +699,17 @@ InternalAllocateAlignedPool (
 /**\r
   Allocates a buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.                            If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -638,12 +749,17 @@ AllocateAlignedPool (
 /**\r
   Allocates a buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -657,14 +773,19 @@ AllocateAlignedRuntimePool (
 }\r
 \r
 /**\r
-  Allocates a buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Allocates a buffer of type EfieservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -678,15 +799,20 @@ AllocateAlignedReservedPool (
 }\r
 \r
 /**\r
-  Allocates and zeros a buffer of type EfiBootServicesData at a specified alignment.\r
+  Allocates and zeros a buffer of a certain pool type at a specified alignment.\r
 \r
-  @param  PoolType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type with an alignment\r
+  specified by Alignment, clears the buffer with zeros, and returns a pointer to the allocated\r
+  buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is not\r
+  enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -708,12 +834,18 @@ InternalAllocateAlignedZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -735,12 +867,18 @@ AllocateAlignedZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -754,14 +892,20 @@ AllocateAlignedRuntimeZeroPool (
 }\r
 \r
 /**\r
-  Allocates and zeros a buffer of type EfiReservedMemoryType at a specified alignment.\r
+  Allocates and zeros a buffer of type EfieservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfieservedMemoryType with an\r
+  alignment specified by Alignment, clears the buffer with zeros, and returns a pointer to the\r
+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there\r
+  is not enough memory at the specified alignment remaining to satisfy the request, then NULL is\r
+  returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -775,16 +919,21 @@ AllocateAlignedReservedZeroPool (
 }\r
 \r
 /**\r
-  Copies a buffer to an allocated buffer of type EfiBootServicesData at a specified alignment.\r
+  Copies a buffer to an allocated buffer of a certain pool type at a specified alignment.\r
 \r
-  @param  PoolType The type of pool to allocate.\r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of a certain pool type with an alignment\r
+  specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0, then a valid\r
+  buffer of 0 size is returned.  If there is not enough memory at the specified alignment remaining\r
+  to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  PoolType              The type of pool to allocate.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -810,13 +959,18 @@ InternalAllocateAlignedCopyPool (
 /**\r
   Copies a buffer to an allocated buffer of type EfiBootServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -842,13 +996,18 @@ AllocateAlignedCopyPool (
 /**\r
   Copies a buffer to an allocated buffer of type EfiRuntimeServicesData at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -865,13 +1024,18 @@ AllocateAlignedRuntimeCopyPool (
 /**\r
   Copies a buffer to an allocated buffer of type EfiReservedMemoryType at a specified alignment.\r
 \r
-  @param  AllocationSize The number of bytes to allocate.\r
-  @param  Buffer The buffer to copy to the allocated buffer.\r
-  @param  Alignment The requested alignment of the allocation.  Must be a power of two.\r
-  If Alignment is zero, then byte alignment is used.\r
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType type with an\r
+  alignment specified by Alignment.  The allocated buffer is returned.  If AllocationSize is 0,\r
+  then a valid buffer of 0 size is returned.  If there is not enough memory at the specified\r
+  alignment remaining to satisfy the request, then NULL is returned.\r
+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().\r
 \r
-  @return A pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
-  If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+  @param  AllocationSize        The number of bytes to allocate.\r
+  @param  Buffer                The buffer to copy to the allocated buffer.\r
+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.\r
+                                If Alignment is zero, then byte alignment is used.\r
+\r
+  @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
 **/\r
 VOID *\r
@@ -889,7 +1053,12 @@ AllocateAlignedReservedCopyPool (
   Frees a buffer that was previously allocated with one of the aligned pool allocation functions \r
   in the Memory Allocation Library.\r
 \r
-  @param  Buffer Pointer to the buffer to free.\r
+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the\r
+  aligned pool allocation services of the Memory Allocation Library.\r
+  If Buffer was not allocated with an aligned pool allocation function in the Memory Allocation\r
+  Library, then ASSERT().\r
+\r
+  @param  Buffer                Pointer to the buffer to free.\r
 \r
 **/\r
 VOID\r
index 5faa08d..7797608 100644 (file)
@@ -21,7 +21,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 /**\r
   An empty function to pass error checking of CreateEventEx (). \r
   \r
-  This empty function enusres that EFI_EVENT_NOTIFY_SIGNAL_ALL is error
+  This empty function ensures that EFI_EVENT_NOTIFY_SIGNAL_ALL is error
   checked correctly since it is now mapped into CreateEventEx() in UEFI 2.0.
   \r
 **/\r
index 9114135..7cb1e01 100644 (file)
@@ -434,12 +434,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
         <FfsFormatKey>LIBRARY</FfsFormatKey>\r
       </ModuleSaBuildOptions>\r
     </ModuleSA>\r
-    <ModuleSA SupArchList="IA32" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="4c38a173-b317-4f29-a7bf-1cc7e10ccb10">\r
-      <ModuleSaBuildOptions>\r
-        <FvBinding>NULL</FvBinding>\r
-        <FfsFormatKey>LIBRARY</FfsFormatKey>\r
-      </ModuleSaBuildOptions>\r
-    </ModuleSA>\r
     <ModuleSA SupArchList="IA32" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="51C4C059-67F0-4e3c-9A55-FF42A8291C8C">\r
       <ModuleSaBuildOptions>\r
         <FvBinding>NULL</FvBinding>\r
@@ -1010,12 +1004,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
         <FfsFormatKey>LIBRARY</FfsFormatKey>\r
       </ModuleSaBuildOptions>\r
     </ModuleSA>\r
-    <ModuleSA SupArchList="IPF" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="4c38a173-b317-4f29-a7bf-1cc7e10ccb10">\r
-      <ModuleSaBuildOptions>\r
-        <FvBinding>NULL</FvBinding>\r
-        <FfsFormatKey>LIBRARY</FfsFormatKey>\r
-      </ModuleSaBuildOptions>\r
-    </ModuleSA>\r
     <ModuleSA SupArchList="IPF" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="51C4C059-67F0-4e3c-9A55-FF42A8291C8C">\r
       <ModuleSaBuildOptions>\r
         <FvBinding>NULL</FvBinding>\r
@@ -1592,12 +1580,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
         <FfsFormatKey>LIBRARY</FfsFormatKey>\r
       </ModuleSaBuildOptions>\r
     </ModuleSA>\r
-    <ModuleSA SupArchList="X64" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="4c38a173-b317-4f29-a7bf-1cc7e10ccb10">\r
-      <ModuleSaBuildOptions>\r
-        <FvBinding>NULL</FvBinding>\r
-        <FfsFormatKey>LIBRARY</FfsFormatKey>\r
-      </ModuleSaBuildOptions>\r
-    </ModuleSA>\r
     <ModuleSA SupArchList="X64" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="51C4C059-67F0-4e3c-9A55-FF42A8291C8C">\r
       <ModuleSaBuildOptions>\r
         <FvBinding>NULL</FvBinding>\r
@@ -2168,12 +2150,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
         <FfsFormatKey>LIBRARY</FfsFormatKey>\r
       </ModuleSaBuildOptions>\r
     </ModuleSA>\r
-    <ModuleSA SupArchList="EBC" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="4c38a173-b317-4f29-a7bf-1cc7e10ccb10">\r
-      <ModuleSaBuildOptions>\r
-        <FvBinding>NULL</FvBinding>\r
-        <FfsFormatKey>LIBRARY</FfsFormatKey>\r
-      </ModuleSaBuildOptions>\r
-    </ModuleSA>\r
     <ModuleSA SupArchList="EBC" PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec" ModuleGuid="51C4C059-67F0-4e3c-9A55-FF42A8291C8C">\r
       <ModuleSaBuildOptions>\r
         <FvBinding>NULL</FvBinding>\r
index 5be6685..7f29b35 100644 (file)
@@ -1154,7 +1154,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
     <Filename>Library/BasePostCodeLibPort80/BasePostCodeLibPort80.msa</Filename>\r
     <Filename>Library/BasePostCodeLibDebug/BasePostCodeLibDebug.msa</Filename>\r
     <Filename>Library/PeiDxePostCodeLibReportStatusCode/PeiDxePostCodeLibReportStatusCode.msa</Filename>\r
-    <Filename>Library/BaseSmbusLib/BaseSmbusLib.msa</Filename>\r
     <Filename>Library/PeiSmbusLib/PeiSmbusLib.msa</Filename>\r
     <Filename>Library/DxeSmbusLib/DxeSmbusLib.msa</Filename>\r
     <Filename>Library/BaseUefiDecompressLib/BaseUefiDecompressLib.msa</Filename>\r