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 #include "MemLibInternals.h"
  27
  28 /**
  29   Fills a target buffer with a 64-bit value, and returns the target buffer.
  30
  31   This function fills Length bytes of Buffer with the 64-bit value specified by
  32   Value, and returns Buffer. Value is repeated every 64-bits in for Length
  33   bytes of Buffer.
  34
  35   If Length > 0 and Buffer is NULL, then ASSERT().
  36   If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
  37   If Buffer is not aligned on a 64-bit boundary, then ASSERT().
  38   If Length is not aligned on a 64-bit boundary, then ASSERT().
  39
  40   @param  Buffer  Pointer to the target buffer to fill.
  41   @param  Length  Number of bytes in Buffer to fill.
  42   @param  Value   Value with which to fill Length bytes of Buffer.
  43
  44   @return Buffer.
  45
  46 **/
  47 VOID *
  48 EFIAPI
  49 SetMem64 (
  50   OUT VOID   *Buffer,
  51   IN UINTN   Length,
  52   IN UINT64  Value
  53   )
  54 {
  55   if (Length == 0) {
  56     return Buffer;
  57   }
  58
  59   ASSERT (Buffer != NULL);
  60   ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));
  61   ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);
  62   ASSERT ((Length & (sizeof (Value) - 1)) == 0);
  63
  64   return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);
  65 }