EdkCompatibilityPkg/Foundation/Library/EdkIIGlueLib/Library/BaseMemoryLib/SetMem32Wrapper.c

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