Program SD Cards into 4-bit mode (support for this is required in the spec). This...

[mirror_edk2.git] / EdkCompatibilityPkg / Foundation / Include / EfiStdArg.h

/*++\r
\r
Copyright (c) 2004, 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
Module Name:\r
\r
  EfiStdArg.h\r
\r
Abstract:\r
\r
  Support for variable length argument lists using the ANSI standard.\r
  \r
  Since we are using the ANSI standard we used the standard nameing and\r
  did not folow the coding convention\r
\r
  VA_LIST  - typedef for argument list.\r
  VA_START (VA_LIST Marker, argument before the ...) - Init Marker for use.\r
  VA_END (VA_LIST Marker) - Clear Marker\r
  VA_ARG (VA_LIST Marker, var arg size) - Use Marker to get an argumnet from\r
    the ... list. You must know the size and pass it in this macro.\r
\r
  example:\r
\r
  UINTN\r
  ExampleVarArg (\r
    IN UINTN  NumberOfArgs,\r
    ...\r
    )\r
  {\r
    VA_LIST Marker;\r
    UINTN   Index;\r
    UINTN   Result;\r
\r
    //\r
    // Initialize the Marker\r
    //\r
    VA_START (Marker, NumberOfArgs);\r
    for (Index = 0, Result = 0; Index < NumberOfArgs; Index++) {\r
      //\r
      // The ... list is a series of UINTN values, so average them up.\r
      //\r
      Result += VA_ARG (Marker, UINTN);\r
    }\r
\r
    VA_END (Marker);\r
    return Result\r
  }\r
\r
--*/\r
\r
#ifndef _EFISTDARG_H_\r
#define _EFISTDARG_H_\r
\r
#define _EFI_INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))\r
\r
#if defined(__CC_ARM)\r
//\r
// RVCT ARM variable argument list support.\r
//\r
\r
///\r
/// Variable used to traverse the list of arguments. This type can vary by \r
/// implementation and could be an array or structure. \r
///\r
#ifdef __APCS_ADSABI\r
  typedef int         *va_list[1];\r
  #define VA_LIST     va_list\r
#else\r
  typedef struct __va_list { void *__ap; } va_list;\r
  #define VA_LIST                          va_list\r
#endif\r
\r
#define VA_START(Marker, Parameter)   __va_start(Marker, Parameter)\r
\r
#define VA_ARG(Marker, TYPE)          __va_arg(Marker, TYPE)\r
\r
#define VA_END(Marker)                ((void)0)\r
\r
#define VA_COPY(Dest, Start)          __va_copy (Dest, Start)\r
\r
#elif defined(__GNUC__)\r
//\r
// Use GCC built-in macros for variable argument lists.\r
//\r
\r
///\r
/// Variable used to traverse the list of arguments. This type can vary by \r
/// implementation and could be an array or structure. \r
///\r
typedef __builtin_va_list VA_LIST;\r
\r
#define VA_START(Marker, Parameter)  __builtin_va_start (Marker, Parameter)\r
\r
#define VA_ARG(Marker, TYPE)         ((sizeof (TYPE) < sizeof (UINTN)) ? (TYPE)(__builtin_va_arg (Marker, UINTN)) : (TYPE)(__builtin_va_arg (Marker, TYPE)))\r
\r
#define VA_END(Marker)               __builtin_va_end (Marker)\r
\r
#define VA_COPY(Dest, Start)         __builtin_va_copy (Dest, Start)\r
\r
#else\r
\r
//\r
// Also support coding convention rules for var arg macros\r
//\r
#ifndef VA_START\r
\r
typedef CHAR8 *VA_LIST;\r
#define VA_START(ap, v) (ap = (VA_LIST) & (v) + _EFI_INT_SIZE_OF (v))\r
#define VA_ARG(ap, t)   (*(t *) ((ap += _EFI_INT_SIZE_OF (t)) - _EFI_INT_SIZE_OF (t)))\r
#define VA_END(ap)      (ap = (VA_LIST) 0)\r
#define VA_COPY(dest, src) ((void)((dest) = (src)))\r
\r
#endif\r
\r
\r
#endif\r
\r
#endif\r