+++ /dev/null
-/*++\r
-\r
-Copyright (c) 2004 - 2006, Intel Corporation. All rights reserved.<BR>\r
-This program and the accompanying materials \r
-are licensed and made available under the terms and conditions of the BSD License \r
-which accompanies this distribution. The full text of the license may be found at \r
-http://opensource.org/licenses/bsd-license.php \r
- \r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
-\r
-\r
-Module Name:\r
-\r
- EdkIIGlueBaseMemoryLib.h\r
- \r
-Abstract: \r
-\r
- Memory-only library functions with no library constructor/destructor\r
- \r
---*/ \r
- \r
-#ifndef __EDKII_GLUE_BASE_MEMORY_LIB_H__\r
-#define __EDKII_GLUE_BASE_MEMORY_LIB_H__\r
-\r
-\r
-#define CopyMem(_DESTINATIONBUFFER, _SOURCEBUFFER, _LENGTH) GlueCopyMem(_DESTINATIONBUFFER, _SOURCEBUFFER, _LENGTH)\r
-#define ZeroMem(_BUFFER, _LENGTH) GlueZeroMem(_BUFFER, _LENGTH)\r
-#define SetMem(_BUFFER, _LENGTH, _VALUE) GlueSetMem(_BUFFER, _LENGTH, _VALUE)\r
-#define CompareMem(_DESTINATIONBUFFER, _SOURCEBUFFER, _LENGTH) GlueCompareMem(_DESTINATIONBUFFER, _SOURCEBUFFER, _LENGTH)\r
-#define CompareGuid(_GUID1, _GUID2) GlueCompareGuid(_GUID1, _GUID2)\r
-#define ScanGuid(_BUFFER, _LENGTH, _GUID) GlueScanGuid(_BUFFER, _LENGTH, _GUID)\r
-\r
-/**\r
- Copies a source buffer to a destination buffer, and returns the destination buffer.\r
-\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
- DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
- where SourceBuffer overlaps DestinationBuffer.\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
-\r
- @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
- @param SourceBuffer Pointer to the source buffer of the memory copy.\r
- @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
-\r
- @return DestinationBuffer.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-GlueCopyMem (\r
- OUT VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
- );\r
-\r
-/**\r
- Fills a target buffer with a byte value, and returns the target buffer.\r
-\r
- This function fills Length bytes of Buffer with Value, and returns Buffer.\r
- If Length is greater than (MAX_ADDRESS ? Buffer + 1), then ASSERT(). \r
-\r
- @param Buffer Memory to set.\r
- @param Length Number of bytes to set.\r
- @param Value Value of the set operation.\r
-\r
- @return Buffer.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-GlueSetMem (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
- );\r
-\r
-/**\r
- Fills a target buffer with a 16-bit value, and returns the target buffer.\r
-\r
- This function fills Length bytes of Buffer with the 16-bit value specified by\r
- Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
- bytes of Buffer.\r
-\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
- If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
- If Length is not aligned on a 16-bit boundary, then ASSERT().\r
-\r
- @param Buffer Pointer to the target buffer to fill.\r
- @param Length Number of bytes in Buffer to fill.\r
- @param Value Value with which to fill Length bytes of Buffer.\r
-\r
- @return Buffer.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
- );\r
-\r
-/**\r
- Fills a target buffer with a 32-bit value, and returns the target buffer.\r
-\r
- This function fills Length bytes of Buffer with the 32-bit value specified by\r
- Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
- bytes of Buffer.\r
-\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
- If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
- If Length is not aligned on a 32-bit boundary, then ASSERT().\r
-\r
- @param Buffer Pointer to the target buffer to fill.\r
- @param Length Number of bytes in Buffer to fill.\r
- @param Value Value with which to fill Length bytes of Buffer.\r
-\r
- @return Buffer.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
- );\r
-\r
-/**\r
- Fills a target buffer with a 64-bit value, and returns the target buffer.\r
-\r
- This function fills Length bytes of Buffer with the 64-bit value specified by\r
- Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
- bytes of Buffer.\r
-\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
- If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is not aligned on a 64-bit boundary, then ASSERT().\r
-\r
- @param Buffer Pointer to the target buffer to fill.\r
- @param Length Number of bytes in Buffer to fill.\r
- @param Value Value with which to fill Length bytes of Buffer.\r
-\r
- @return Buffer.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
- );\r
-\r
-/**\r
- Fills a target buffer with zeros, and returns the target buffer.\r
-\r
- This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS ? Buffer + 1), then ASSERT(). \r
-\r
- @param Buffer Pointer to the target buffer to fill with zeros.\r
- @param Length Number of bytes in Buffer to fill with zeros.\r
-\r
- @return Buffer.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-GlueZeroMem (\r
- OUT VOID *Buffer,\r
- IN UINTN Length\r
- );\r
-\r
-/**\r
- Compares the contents of two buffers.\r
-\r
- This function compares Length bytes of SourceBuffer to Length bytes of DestinationBuffer.\r
- If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the\r
- value returned is the first mismatched byte in SourceBuffer subtracted from the first\r
- mismatched byte in DestinationBuffer.\r
- If Length > 0 and DestinationBuffer is NULL and Length > 0, then ASSERT().\r
- If Length > 0 and SourceBuffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
-\r
- @param DestinationBuffer Pointer to the destination buffer to compare.\r
- @param SourceBuffer Pointer to the source buffer to compare.\r
- @param Length Number of bytes to compare.\r
-\r
- @return 0 All Length bytes of the two buffers are identical.\r
- @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first\r
- mismatched byte in DestinationBuffer.\r
-\r
-**/\r
-INTN\r
-EFIAPI\r
-GlueCompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
- );\r
-\r
-/**\r
- Scans a target buffer for an 8-bit value, and returns a pointer to the matching 8-bit value\r
- in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from the lowest\r
- address to the highest address for an 8-bit value that matches Value. If a match is found,\r
- then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS ? Buffer + 1), then ASSERT(). \r
-\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
-\r
- @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
- );\r
-\r
-/**\r
- Scans a target buffer for a 16-bit value, and returns a pointer to the matching 16-bit value\r
- in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from the lowest\r
- address to the highest address for a 16-bit value that matches Value. If a match is found,\r
- then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
- If Length is not aligned on a 16-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS ? Buffer + 1), then ASSERT(). \r
-\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
-\r
- @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
- );\r
-\r
-/**\r
- Scans a target buffer for a 32-bit value, and returns a pointer to the matching 32-bit value\r
- in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from the lowest\r
- address to the highest address for a 32-bit value that matches Value. If a match is found,\r
- then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
- If Length is not aligned on a 32-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS ? Buffer + 1), then ASSERT(). \r
-\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
-\r
- @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
- );\r
-\r
-/**\r
- Scans a target buffer for a 64-bit value, and returns a pointer to the matching 64-bit value\r
- in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from the lowest\r
- address to the highest address for a 64-bit value that matches Value. If a match is found,\r
- then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS ? Buffer + 1), then ASSERT(). \r
-\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
-\r
- @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
- );\r
-\r
-/**\r
- Copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
- DestinationGuid, and returns DestinationGuid.\r
- If DestinationGuid is NULL, then ASSERT().\r
- If SourceGuid is NULL, then ASSERT().\r
-\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
-\r
- @return DestinationGuid.\r
-\r
-**/\r
-GUID *\r
-EFIAPI\r
-CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
- );\r
-\r
-/**\r
- Compares two GUIDs.\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
- If there are any bit differences in the two GUIDs, then FALSE is returned.\r
- If Guid1 is NULL, then ASSERT().\r
- If Guid2 is NULL, then ASSERT().\r
-\r
- @param Guid1 A pointer to a 128 bit GUID.\r
- @param Guid2 A pointer to a 128 bit GUID.\r
-\r
- @retval TRUE Guid1 and Guid2 are identical.\r
- @retval FALSE Guid1 and Guid2 are not identical.\r
-\r
-**/\r
-BOOLEAN\r
-EFIAPI\r
-GlueCompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
- );\r
-\r
-/**\r
- Scans a target buffer for a GUID, and returns a pointer to the matching GUID\r
- in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the 128-bit\r
- GUID value that matches Guid. If a match is found, then a pointer to the matching\r
- GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
- If Length is 0, then NULL is returned.\r
- If Length > 0 and Buffer is NULL, then ASSERT().\r
- If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
- If Length is not aligned on a 128-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS ? Buffer + 1), then ASSERT(). \r
-\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Guid Value to search for in the target buffer.\r
-\r
- @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
- );\r
-\r
-#endif\r