MdeModulePkg: Replace BSD License with BSD+Patent License

[mirror_edk2.git] / MdeModulePkg / Universal / SetupBrowserDxe / Expression.h

/** @file\r
Private structure, MACRO and function definitions for User Interface related functionalities.\r
\r
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#ifndef _EXPRESSION_H_\r
#define _EXPRESSION_H_\r
\r
/**\r
  Get the expression list count.\r
\r
  @param  Level                  Which type this expression belong to. Form,\r
                                 statement or option?\r
\r
  @retval >=0                    The expression count\r
  @retval -1                     Input parameter error.\r
\r
**/\r
INTN\r
GetConditionalExpressionCount (\r
  IN EXPRESS_LEVEL       Level\r
  );\r
\r
/**\r
  Reset stack pointer to begin of the stack.\r
\r
**/\r
VOID\r
ResetCurrentExpressionStack (\r
  VOID\r
  );\r
\r
/**\r
  Reset stack pointer to begin of the stack.\r
\r
**/\r
VOID\r
ResetMapExpressionListStack (\r
  VOID\r
  );\r
\r
/**\r
  Reset stack pointer to begin of the stack.\r
\r
**/\r
VOID\r
ResetScopeStack (\r
  VOID\r
  );\r
\r
/**\r
  Push an Operand onto the Stack\r
\r
  @param  Operand                Operand to push.\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the\r
                                 stack.\r
\r
**/\r
EFI_STATUS\r
PushScope (\r
  IN UINT8   Operand\r
  );\r
\r
/**\r
  Get the expression Buffer pointer.\r
\r
  @param  Level                  Which type this expression belong to. Form,\r
                                 statement or option?\r
\r
  @retval  The start pointer of the expression buffer or NULL.\r
\r
**/\r
FORM_EXPRESSION **\r
GetConditionalExpressionList (\r
  IN EXPRESS_LEVEL       Level\r
  );\r
\r
/**\r
  Pop an Operand from the Stack\r
\r
  @param  Operand                Operand to pop.\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the\r
                                 stack.\r
\r
**/\r
EFI_STATUS\r
PopScope (\r
  OUT UINT8     *Operand\r
  );\r
\r
/**\r
  Push the list of map expression onto the Stack\r
\r
  @param  Pointer                Pointer to the list of map expression to be pushed.\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the stack.\r
\r
**/\r
EFI_STATUS\r
PushMapExpressionList (\r
  IN VOID  *Pointer\r
  );\r
\r
/**\r
  Push current expression onto the Stack\r
\r
  @param  Pointer                Pointer to current expression.\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the stack.\r
\r
**/\r
EFI_STATUS\r
PushCurrentExpression (\r
  IN VOID  *Pointer\r
  );\r
\r
/**\r
  Zero extend integer/boolean/date/time to UINT64 for comparing.\r
\r
  @param  Value                  HII Value to be converted.\r
\r
**/\r
VOID\r
ExtendValueToU64 (\r
  IN  EFI_HII_VALUE   *Value\r
  );\r
\r
/**\r
  Push the expression options onto the Stack.\r
\r
  @param  Pointer                Pointer to the current expression.\r
  @param  Level                  Which type this expression belong to. Form,\r
                                 statement or option?\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the stack.\r
\r
**/\r
EFI_STATUS\r
PushConditionalExpression (\r
  IN FORM_EXPRESSION   *Pointer,\r
  IN EXPRESS_LEVEL     Level\r
  );\r
\r
/**\r
  Pop the expression options from the Stack\r
\r
  @param  Level                  Which type this expression belong to. Form,\r
                                 statement or option?\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the stack.\r
\r
**/\r
EFI_STATUS\r
PopConditionalExpression (\r
  IN  EXPRESS_LEVEL      Level\r
  );\r
\r
/**\r
  Pop the list of map expression from the Stack\r
\r
  @param  Pointer                Pointer to the list of map expression to be pop.\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the stack.\r
\r
**/\r
EFI_STATUS\r
PopMapExpressionList (\r
  OUT VOID    **Pointer\r
  );\r
\r
/**\r
  Pop current expression from the Stack\r
\r
  @param  Pointer                Pointer to current expression to be pop.\r
\r
  @retval EFI_SUCCESS            The value was pushed onto the stack.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the stack.\r
\r
**/\r
EFI_STATUS\r
PopCurrentExpression (\r
  OUT VOID    **Pointer\r
  );\r
\r
/**\r
  Evaluate the result of a HII expression.\r
\r
  If Expression is NULL, then ASSERT.\r
\r
  @param  FormSet                FormSet associated with this expression.\r
  @param  Form                   Form associated with this expression.\r
  @param  Expression             Expression to be evaluated.\r
\r
  @retval EFI_SUCCESS            The expression evaluated successfuly\r
  @retval EFI_NOT_FOUND          The Question which referenced by a QuestionId\r
                                 could not be found.\r
  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to grow the\r
                                 stack.\r
  @retval EFI_ACCESS_DENIED      The pop operation underflowed the stack\r
  @retval EFI_INVALID_PARAMETER  Syntax error with the Expression\r
\r
**/\r
EFI_STATUS\r
EvaluateExpression (\r
  IN FORM_BROWSER_FORMSET  *FormSet,\r
  IN FORM_BROWSER_FORM     *Form,\r
  IN OUT FORM_EXPRESSION   *Expression\r
  );\r
/**\r
  Return the result of the expression list. Check the expression list and\r
  return the highest priority express result.\r
  Priority: DisableIf > SuppressIf > GrayOutIf > FALSE\r
\r
  @param  ExpList             The input expression list.\r
  @param  Evaluate            Whether need to evaluate the expression first.\r
  @param  FormSet             FormSet associated with this expression.\r
  @param  Form                Form associated with this expression.\r
\r
  @retval EXPRESS_RESULT      Return the higher priority express result.\r
                              DisableIf > SuppressIf > GrayOutIf > FALSE\r
\r
**/\r
EXPRESS_RESULT\r
EvaluateExpressionList (\r
  IN FORM_EXPRESSION_LIST *ExpList,\r
  IN BOOLEAN              Evaluate,\r
  IN FORM_BROWSER_FORMSET *FormSet, OPTIONAL\r
  IN FORM_BROWSER_FORM    *Form OPTIONAL\r
  );\r
\r
/**\r
  Get Form given its FormId.\r
\r
  @param  FormSet                The formset which contains this form.\r
  @param  FormId                 Id of this form.\r
\r
  @retval Pointer                The form.\r
  @retval NULL                   Specified Form is not found in the formset.\r
\r
**/\r
FORM_BROWSER_FORM *\r
IdToForm (\r
  IN FORM_BROWSER_FORMSET  *FormSet,\r
  IN UINT16                FormId\r
  );\r
\r
#endif // _EXPRESSION_H\r