/** @file | |
ScanMem8() implementation. | |
Copyright (c) 2006, Intel Corporation<BR> | |
All rights reserved. This program and the accompanying materials | |
are licensed and made available under the terms and conditions of the BSD License | |
which accompanies this distribution. The full text of the license may be found at | |
http://opensource.org/licenses/bsd-license.php | |
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, | |
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. | |
Module Name: ScanMem8Wrapper.c | |
The following BaseMemoryLib instances share the same version of this file: | |
BaseMemoryLib | |
BaseMemoryLibMmx | |
BaseMemoryLibSse2 | |
BaseMemoryLibRepStr | |
PeiMemoryLib | |
UefiMemoryLib | |
**/ | |
#include "MemLibInternals.h" | |
/** | |
Scans a target buffer for an 8-bit value, and returns a pointer to the | |
matching 8-bit value in the target buffer. | |
This function searches target the buffer specified by Buffer and Length from | |
the lowest address to the highest address for an 8-bit value that matches | |
Value. If a match is found, then a pointer to the matching byte in the target | |
buffer is returned. If no match is found, then NULL is returned. If Length is | |
0, then NULL is returned. | |
If Buffer is NULL, then ASSERT(). | |
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). | |
@param Buffer Pointer to the target buffer to scan. | |
@param Length Number of bytes in Buffer to scan. | |
@param Value Value to search for in the target buffer. | |
@return Pointer to the first occurrence or NULL if not found. | |
@retval NULL if Length == 0 or Value was not found. | |
**/ | |
VOID * | |
EFIAPI | |
ScanMem8 ( | |
IN CONST VOID *Buffer, | |
IN UINTN Length, | |
IN UINT8 Value | |
) | |
{ | |
ASSERT (Buffer != NULL); | |
ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1); | |
if ((Length /= sizeof (Value)) == 0) { | |
return NULL; | |
} | |
return (VOID*)InternalMemScanMem8 (Buffer, Length, Value); | |
} |