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