MdePkg/Library/BaseMemoryLibRepStr/SetMem16Wrapper.c

   1 /** @file
   2   SetMem16() 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:  SetMem16Wrapper.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     UefiMemoryLib
  23
  24 **/
  25
  26 #include "MemLibInternals.h"
  27
  28 /**
  29   Fills a target buffer with a 16-bit value, and returns the target buffer.
  30
  31   This function fills Length bytes of Buffer with the 16-bit value specified by
  32   Value, and returns Buffer. Value is repeated every 16-bits in for Length
  33   bytes of Buffer.
  34
  35   If Buffer is NULL and Length > 0, then ASSERT().
  36   If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
  37   If Buffer is not aligned on a 16-bit boundary, then ASSERT().
  38   If Length is not aligned on a 16-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 SetMem16 (
  50   OUT     VOID                      *Buffer,
  51   IN      UINTN                     Length,
  52   IN      UINT16                    Value
  53   )
  54 {
  55   ASSERT (!(Buffer == NULL && Length > 0));
  56   ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);
  57   ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);
  58   ASSERT ((Length & (sizeof (Value) - 1)) == 0);
  59
  60   if ((Length /= sizeof (Value)) == 0) {
  61     return Buffer;
  62   }
  63   return InternalMemSetMem16 (Buffer, Length, Value);
  64 }