Overview
C API (Core)
struct EventCallFunction { UINT32 handle; struct Argument** args; UINT32 count; };

Call a function that was previously obtained in a call to EVENT_FUNCTION_GET.

Fields

UINT32 handle IN
Handle of function to call, returned from a call to EVENT_FUNCTION_GET.
struct Argument** args IN/OUT
Function arguments, any number of which may be outputs as well as inputs.
UINT32 count IN/OUT
The number of arguments passed. Also used to return additional data in case of error.

Action

  • Execute the specified function using the arguments supplied in EventFunction.
  • Modify any arguments that serve as return arguments, and set the flag F_MODIFIED on those arguments only.

Return Codes

  • E_BAD_ARG_COUNT Argument list is of the wrong length (return expected length in count).
  • E_BAD_ARG_TYPE Argument is of the wrong type (return zero-based index of offending argument in count).
  • E_BAD_ARG_SIZE Argument is of the wrong size (return zero-based index of offending argument in count).

Example

C++ Source Code (against 1199)
// TODO // ok return C_OK;