MdePkg/Library/DxeMemoryLib/SetMem64Wrapper.c

   1 /** @file
   2   SetMem64() implementation.
   3
   4   Copyright (c) 2006, Intel Corporation<BR>
   5   All rights reserved. This program and the accompanying materials
   6   are licensed and made available under the terms and conditions of the BSD License
   7   which accompanies this distribution.  The full text of the license may be found at
   8   http://opensource.org/licenses/bsd-license.php
   9
  10   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13   Module Name:  SetMem64Wrapper.c
  14
  15   The following BaseMemoryLib instances share the same version of this file:
  16
  17     BaseMemoryLib
  18     BaseMemoryLibMmx
  19     BaseMemoryLibSse2
  20     BaseMemoryLibRepStr
  21     PeiMemoryLib
  22     DxeMemoryLib
  23
  24 **/
  25
  26
  27 #include "MemLibInternals.h"
  28
  29 /**
  30   Fills a target buffer with a 64-bit value, and returns the target buffer.
  31
  32   This function fills Length bytes of Buffer with the 64-bit value specified by
  33   Value, and returns Buffer. Value is repeated every 64-bits in for Length
  34   bytes of Buffer.
  35
  36   If Length > 0 and Buffer is NULL, then ASSERT().
  37   If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
  38   If Buffer is not aligned on a 64-bit boundary, then ASSERT().
  39   If Length is not aligned on a 64-bit boundary, then ASSERT().
  40
  41   @param  Buffer  Pointer to the target buffer to fill.
  42   @param  Length  Number of bytes in Buffer to fill.
  43   @param  Value   Value with which to fill Length bytes of Buffer.
  44
  45   @return Buffer.
  46
  47 **/
  48 VOID *
  49 EFIAPI
  50 SetMem64 (
  51   OUT VOID   *Buffer,
  52   IN UINTN   Length,
  53   IN UINT64  Value
  54   )
  55 {
  56   if (Length == 0) {
  57     return Buffer;
  58   }
  59
  60   ASSERT (Buffer != NULL);
  61   ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));
  62   ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);
  63   ASSERT ((Length & (sizeof (Value) - 1)) == 0);
  64
  65   return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);
  66 }