4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/** @file
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CompareMem() implementation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync The following BaseMemoryLib instances contain the same copy of this file:
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BaseMemoryLib
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BaseMemoryLibMmx
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BaseMemoryLibSse2
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BaseMemoryLibRepStr
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BaseMemoryLibOptDxe
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BaseMemoryLibOptPei
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync PeiMemoryLib
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UefiMemoryLib
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCopyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis program and the accompanying materials
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncare licensed and made available under the terms and conditions of the BSD License
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncwhich accompanies this distribution. The full text of the license may be found at
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsynchttp://opensource.org/licenses/bsd-license.php.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncTHE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncWITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include "MemLibInternals.h"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Compares the contents of two buffers.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function compares Length bytes of SourceBuffer to Length bytes of DestinationBuffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync value returned is the first mismatched byte in SourceBuffer subtracted from the first
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync mismatched byte in DestinationBuffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If Length > 0 and DestinationBuffer is NULL, then ASSERT().
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If Length > 0 and SourceBuffer is NULL, then ASSERT().
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DestinationBuffer A pointer to the destination buffer to compare.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param SourceBuffer A pointer to the source buffer to compare.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Length The number of bytes to compare.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return 0 All Length bytes of the two buffers are identical.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync mismatched byte in DestinationBuffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncINTN
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFIAPI
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCompareMem (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN CONST VOID *DestinationBuffer,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN CONST VOID *SourceBuffer,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINTN Length
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Length == 0 || DestinationBuffer == SourceBuffer) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT (DestinationBuffer != NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT (SourceBuffer != NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}