]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Library/SmmMemoryAllocationLib/MemoryAllocationLib.c
Minor grammatical work--mostly adding periods. Items with ONLY period added did...
[mirror_edk2.git] / MdePkg / Library / SmmMemoryAllocationLib / MemoryAllocationLib.c
index 3a539e36432aa6903c2fd5a398ce22a85d9819bc..f8ab33a44ac28536f0d8181e29ac04f0e1832d77 100644 (file)
 /**\r
   Allocates one or more 4KB pages of a certain memory type.\r
 \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
+  Allocates the number of 4KB pages of a certain memory type and returns a pointer \r
+  to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If \r
+  Pages is 0, then NULL is returned.   If there is not enough memory remaining to \r
+  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
@@ -65,10 +66,10 @@ InternalAllocatePages (
 /**\r
   Allocates one or more 4KB pages of type EfiBootServicesData.\r
 \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
+  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer \r
+  to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If \r
+  Pages is 0, then NULL is returned.  If there is not enough memory remaining to \r
+  satisfy the request, then NULL is returned.\r
 \r
   @param  Pages                 The number of 4 KB pages to allocate.\r
 \r
@@ -87,10 +88,10 @@ AllocatePages (
 /**\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
+  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a \r
+  pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  \r
+  If Pages is 0, then NULL is returned.  If there is not enough memory remaining \r
+  to satisfy the request, then NULL is returned.\r
 \r
   @param  Pages                 The number of 4 KB pages to allocate.\r
 \r
@@ -109,10 +110,10 @@ AllocateRuntimePages (
 /**\r
   Allocates one or more 4KB pages of type EfiReservedMemoryType.\r
 \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
+  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a \r
+  pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  \r
+  If Pages is 0, then NULL is returned.  If there is not enough memory remaining \r
+  to satisfy the request, then NULL is returned.\r
 \r
   @param  Pages                 The number of 4 KB pages to allocate.\r
 \r
@@ -132,13 +133,13 @@ AllocateReservedPages (
   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.  If it is not possible to free allocated pages, then this function will\r
-  perform no actions.\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  \r
+  Buffer must have been allocated on a previous call to the page allocation services \r
+  of the Memory Allocation Library.  If it is not possible to free allocated pages, \r
+  then this function will perform no actions.\r
   \r
-  If Buffer was not allocated with a page allocation function in the Memory Allocation Library,\r
-  then ASSERT().\r
+  If Buffer was not allocated with a page allocation function in the Memory Allocation \r
+  Library, then ASSERT().\r
   If Pages is zero, then ASSERT().\r
  \r
   @param  Buffer                The pointer to the buffer of pages to free.\r
@@ -162,15 +163,16 @@ FreePages (
 /**\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
+  Allocates the number of 4KB pages specified by Pages of a certain memory type \r
+  with an alignment specified by Alignment.  The allocated buffer is returned.  \r
+  If Pages is 0, then NULL is returned. If there is not enough memory at the \r
+  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
   @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
+  @param  Alignment             The requested alignment of the allocation.  \r
+                                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
@@ -247,15 +249,16 @@ InternalAllocateAlignedPages (
 /**\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
+  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData \r
+  with an alignment specified by Alignment.  The allocated buffer is returned.  \r
+  If Pages is 0, then NULL is returned.  If there is not enough memory at the \r
+  specified alignment remaining to satisfy the request, then NULL is returned.\r
   \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
+  @param  Alignment             The requested alignment of the allocation.  \r
+                                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
@@ -274,15 +277,16 @@ AllocateAlignedPages (
 /**\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
+  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData \r
+  with an alignment specified by Alignment.  The allocated buffer is returned.  \r
+  If Pages is 0, then NULL is returned.  If there is not enough memory at the \r
+  specified alignment remaining to satisfy the request, then NULL is returned.\r
   \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
+  @param  Alignment             The requested alignment of the allocation.  \r
+                                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
@@ -301,15 +305,16 @@ AllocateAlignedRuntimePages (
 /**\r
   Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.\r
 \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
+  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType \r
+  with an alignment specified by Alignment.  The allocated buffer is returned.  \r
+  If Pages is 0, then NULL is returned.  If there is not enough memory at the \r
+  specified alignment remaining to satisfy the request, then NULL is returned.\r
   \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
+  @param  Alignment             The requested alignment of the allocation.  \r
+                                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
@@ -329,13 +334,13 @@ AllocateAlignedReservedPages (
   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.  If it is not possible to free allocated pages, then this function will \r
-  perform no actions.\r
+  Frees the number of 4KB pages specified by Pages from the buffer specified by \r
+  Buffer.  Buffer must have been allocated on a previous call to the aligned page \r
+  allocation services of the Memory Allocation Library.  If it is not possible to \r
+  free allocated pages, then this function will perform no actions.\r
   \r
-  If Buffer was not allocated with an aligned page allocation function in the Memory Allocation\r
-  Library, then ASSERT().\r
+  If Buffer was not allocated with an aligned page allocation function in the \r
+  Memory Allocation Library, then ASSERT().\r
   If Pages is zero, then ASSERT().\r
   \r
   @param  Buffer                The pointer to the buffer of pages to free.\r
@@ -359,9 +364,10 @@ FreeAlignedPages (
 /**\r
   Allocates a buffer of a certain pool type.\r
 \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
+  Allocates the number bytes specified by AllocationSize of a certain pool type \r
+  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 \r
+  satisfy the request, then NULL is returned.\r
 \r
   @param  MemoryType            The type of memory to allocate.\r
   @param  AllocationSize        The number of bytes to allocate.\r
@@ -388,9 +394,10 @@ InternalAllocatePool (
 /**\r
   Allocates a buffer of type EfiBootServicesData.\r
 \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
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData \r
+  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 \r
+  satisfy the request, then NULL is returned.\r
 \r
   @param  AllocationSize        The number of bytes to allocate.\r
 \r
@@ -409,9 +416,10 @@ AllocatePool (
 /**\r
   Allocates a buffer of type EfiRuntimeServicesData.\r
 \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
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData \r
+  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 \r
+  satisfy the request, then NULL is returned.\r
 \r
   @param  AllocationSize        The number of bytes to allocate.\r
 \r
@@ -430,9 +438,10 @@ AllocateRuntimePool (
 /**\r
   Allocates a buffer of type EfiReservedMemoryType.\r
 \r
-  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType 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
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType \r
+  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 \r
+  satisfy the request, then NULL is returned.\r
 \r
   @param  AllocationSize        The number of bytes to allocate.\r
 \r
@@ -451,10 +460,10 @@ AllocateReservedPool (
 /**\r
   Allocates and zeros a buffer of a certain pool type.\r
 \r
-  Allocates the number bytes specified by AllocationSize of a certain 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
+  Allocates the number bytes specified by AllocationSize of a certain pool type, \r
+  clears the buffer with zeros, and returns a pointer to the allocated buffer.  \r
+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is \r
+  not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
   @param  PoolType              The type of memory to allocate.\r
   @param  AllocationSize        The number of bytes to allocate and zero.\r
@@ -480,10 +489,10 @@ InternalAllocateZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiBootServicesData.\r
 \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
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, \r
+  clears the buffer with zeros, and returns a pointer to the allocated buffer.  \r
+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is \r
+  not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
   @param  AllocationSize        The number of bytes to allocate and zero.\r
 \r
@@ -502,10 +511,10 @@ AllocateZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiRuntimeServicesData.\r
 \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
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, \r
+  clears the buffer with zeros, and returns a pointer to the allocated buffer.  \r
+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is \r
+  not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
   @param  AllocationSize        The number of bytes to allocate and zero.\r
 \r
@@ -524,10 +533,10 @@ AllocateRuntimeZeroPool (
 /**\r
   Allocates and zeros a buffer of type EfiReservedMemoryType.\r
 \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
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, \r
+  clears the   buffer with zeros, and returns a pointer to the allocated buffer.  \r
+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is \r
+  not enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
   @param  AllocationSize        The number of bytes to allocate and zero.\r
 \r
@@ -546,11 +555,11 @@ AllocateReservedZeroPool (
 /**\r
   Copies a buffer to an allocated buffer of a certain pool type.\r
 \r
-  Allocates the number bytes specified by AllocationSize of a certain 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
+  Allocates the number bytes specified by AllocationSize of a certain pool type, \r
+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns \r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer \r
+  of 0 size is returned.  If there is not enough memory remaining to satisfy the \r
+  request, then NULL is returned. If Buffer is NULL, then ASSERT().\r
   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). \r
 \r
   @param  PoolType              The type of pool to allocate.\r
@@ -582,10 +591,11 @@ InternalAllocateCopyPool (
 /**\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
+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, \r
+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns \r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer \r
+  of 0 size is returned.  If there is not enough memory remaining to satisfy the \r
+  request, then NULL is returned.\r
   \r
   If Buffer is NULL, then ASSERT().\r
   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). \r
@@ -609,10 +619,11 @@ AllocateCopyPool (
 /**\r
   Copies a buffer to an allocated buffer of type EfiRuntimeServicesData.\r
 \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
+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, \r
+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns \r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer \r
+  of 0 size is returned.  If there is not enough memory remaining to satisfy the \r
+  request, then NULL is returned.\r
   \r
   If Buffer is NULL, then ASSERT().\r
   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). \r
@@ -636,10 +647,11 @@ AllocateRuntimeCopyPool (
 /**\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
+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, \r
+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns \r
+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer \r
+  of 0 size is returned.  If there is not enough memory remaining to satisfy the \r
+  request, then NULL is returned.\r
   \r
   If Buffer is NULL, then ASSERT().\r
   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). \r
@@ -670,14 +682,14 @@ AllocateReservedCopyPool (
   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not \r
   enough memory remaining to satisfy the request, then NULL is returned.\r
   \r
-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize\r
-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
+  If the allocation of the new buffer is successful and the smaller of NewSize \r
+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
 \r
   @param  PoolType       The type of pool to allocate.\r
   @param  OldSize        The size, in bytes, of OldBuffer.\r
   @param  NewSize        The size, in bytes, of the buffer to reallocate.\r
-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional \r
-                         parameter that may be NULL.\r
+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an \r
+                         optional parameter that may be NULL.\r
 \r
   @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
@@ -710,13 +722,13 @@ InternalReallocatePool (
   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not \r
   enough memory remaining to satisfy the request, then NULL is returned.\r
   \r
-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize\r
-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
+  If the allocation of the new buffer is successful and the smaller of NewSize \r
+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
 \r
   @param  OldSize        The size, in bytes, of OldBuffer.\r
   @param  NewSize        The size, in bytes, of the buffer to reallocate.\r
-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional \r
-                         parameter that may be NULL.\r
+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an \r
+                         optional parameter that may be NULL.\r
 \r
   @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
@@ -736,19 +748,19 @@ ReallocatePool (
   Reallocates a buffer of type EfiRuntimeServicesData.\r
 \r
   Allocates and zeros the number bytes specified by NewSize from memory of type\r
-  EfiRuntimeServicesData.  If OldBuffer is not NULL, then the smaller of OldSize and \r
-  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and \r
+  EfiRuntimeServicesData.  If OldBuffer is not NULL, then the smaller of OldSize \r
+  and NewSize bytes are copied from OldBuffer to the newly allocated buffer, and \r
   OldBuffer is freed.  A pointer to the newly allocated buffer is returned.  \r
   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not \r
   enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize\r
-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
+  If the allocation of the new buffer is successful and the smaller of NewSize \r
+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
 \r
   @param  OldSize        The size, in bytes, of OldBuffer.\r
   @param  NewSize        The size, in bytes, of the buffer to reallocate.\r
-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional \r
-                         parameter that may be NULL.\r
+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an \r
+                         optional parameter that may be NULL.\r
 \r
   @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
@@ -768,19 +780,19 @@ ReallocateRuntimePool (
   Reallocates a buffer of type EfiReservedMemoryType.\r
 \r
   Allocates and zeros the number bytes specified by NewSize from memory of type\r
-  EfiReservedMemoryType.  If OldBuffer is not NULL, then the smaller of OldSize and \r
-  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and \r
+  EfiReservedMemoryType.  If OldBuffer is not NULL, then the smaller of OldSize \r
+  and NewSize bytes are copied from OldBuffer to the newly allocated buffer, and \r
   OldBuffer is freed.  A pointer to the newly allocated buffer is returned.  \r
   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not \r
   enough memory remaining to satisfy the request, then NULL is returned.\r
 \r
-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize\r
-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
+  If the allocation of the new buffer is successful and the smaller of NewSize \r
+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().\r
 \r
   @param  OldSize        The size, in bytes, of OldBuffer.\r
   @param  NewSize        The size, in bytes, of the buffer to reallocate.\r
-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional \r
-                         parameter that may be NULL.\r
+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an \r
+                         optional parameter that may be NULL.\r
 \r
   @return A pointer to the allocated buffer or NULL if allocation fails.\r
 \r
@@ -797,15 +809,16 @@ ReallocateReservedPool (
 }\r
 \r
 /**\r
-  Frees a buffer that was previously allocated with one of the pool allocation functions in the\r
-  Memory Allocation Library.\r
+  Frees a buffer that was previously allocated with one of the pool allocation \r
+  functions in the 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.  If it is not possible to free pool\r
-  resources, then this function will perform no actions.\r
+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a \r
+  previous call to the pool allocation services of the Memory Allocation Library.  \r
+  If it is not possible to free pool resources, then this function will perform \r
+  no actions.\r
   \r
-  If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,\r
-  then ASSERT().\r
+  If Buffer was not allocated with a pool allocation function in the Memory \r
+  Allocation Library, then ASSERT().\r
 \r
   @param  Buffer                The pointer to the buffer to free.\r
 \r