Update FUNCTION_ENTRY_POINT() to be compatible with a wider variety of input parameters.

[mirror_edk2.git] / MdePkg / Include / Ebc / ProcessorBind.h

diff --git a/MdePkg/Include/Ebc/ProcessorBind.h b/MdePkg/Include/Ebc/ProcessorBind.h
index a550f42bd3cc986fad46aa21457bc382b64052fb..966ddb67813b3dbed497932e4f51f061b23e859b 100644 (file)
--- a/MdePkg/Include/Ebc/ProcessorBind.h
+++ b/MdePkg/Include/Ebc/ProcessorBind.h
@@ -4,7 +4,7 @@
   We currently only have one EBC complier so there may be some Intel compiler\r
   specific functions in this file.\r
 \r
-  Copyright (c) 2006, Intel Corporation                                                         \r
+  Copyright (c) 2006, Intel Corporation<BR>                                                         \r
   All rights reserved. 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
@@ -18,9 +18,9 @@
 #ifndef __PROCESSOR_BIND_H__\r
 #define __PROCESSOR_BIND_H__\r
 \r
-//\r
-// Define the processor type so other code can make processor based choices\r
-//\r
+///\r
+/// Define the processor type so other code can make processor based choices\r
+///\r
 #define MDE_CPU_EBC\r
 \r
 //\r
@@ -29,7 +29,7 @@
 typedef char                  INT8;\r
 typedef unsigned char         BOOLEAN;\r
 typedef unsigned char         UINT8;\r
-typedef unsigned char         CHAR8;\r
+typedef char                  CHAR8;\r
 \r
 typedef short                 INT16;\r
 typedef unsigned short        UINT16;\r
@@ -41,45 +41,56 @@ typedef unsigned int          UINT32;
 typedef __int64               INT64;\r
 typedef unsigned __int64      UINT64;\r
 \r
-//\r
-// "long" type scales to the processor native size with EBC compiler\r
-//\r
+///\r
+/// "long" type scales to the processor native size with EBC compiler\r
+///\r
 typedef long                  INTN;\r
 typedef unsigned long         UINTN;\r
 \r
 #define UINT8_MAX 0xff\r
 \r
-//\r
-// Scalable macro to set the most significant bit in a natural number\r
-//\r
+///\r
+/// Scalable macro to set the most significant bit in a natural number\r
+///\r
 #define MAX_BIT     (1ULL << (sizeof (INTN) * 8 - 1)) \r
 #define MAX_2_BITS  (3ULL << (sizeof (INTN) * 8 - 2))\r
 \r
-//\r
-// Maximum legal EBC address\r
-//\r
+///\r
+/// Maximum legal EBC address\r
+///\r
 #define MAX_ADDRESS   ((UINTN) ~0)\r
 \r
-//\r
-// The stack alignment required for EBC\r
-//\r
+///\r
+/// The stack alignment required for EBC\r
+///\r
 #define CPU_STACK_ALIGNMENT   sizeof(UINTN)\r
 \r
-//\r
-// Modifier to ensure that all protocol member functions and EFI intrinsics\r
-// use the correct C calling convention. All protocol member functions and\r
-// EFI intrinsics are required to modify thier member functions with EFIAPI.\r
-//\r
+///\r
+/// Modifier to ensure that all protocol member functions and EFI intrinsics\r
+/// use the correct C calling convention. All protocol member functions and\r
+/// EFI intrinsics are required to modify their member functions with EFIAPI.\r
+///\r
 #define EFIAPI    \r
 \r
-//\r
-// The Microsoft* C compiler can removed references to unreferenced data items\r
-//  if the /OPT:REF linker option is used. We defined a macro as this is a \r
-//  a non standard extension. Currently not supported by the EBC compiler\r
-//\r
+///\r
+/// The Microsoft* C compiler can removed references to unreferenced data items\r
+///  if the /OPT:REF linker option is used. We defined a macro as this is a \r
+///  a non standard extension. Currently not supported by the EBC compiler\r
+///\r
 #define GLOBAL_REMOVE_IF_UNREFERENCED\r
 \r
-#define FUNCTION_ENTRY_POINT(p) (p)\r
+\r
+/**\r
+  Return the pointer to the first instruction of a function given a function pointer.\r
+  On EBC architectures, these two pointer values are the same, \r
+  so the implementation of this macro is very simple.\r
+  \r
+  @param  FunctionPointer   A pointer to a function.\r
+\r
+  @return The pointer to the first instruction of a function given a function pointer.\r
+**/\r
+\r
+#define FUNCTION_ENTRY_POINT(FunctionPointer) (VOID *)(UINTN)(FunctionPointer)\r
 \r
 #endif \r
 \r