API Quick Reference Guide

  • 2020
  • 09/30/2019
  • Public Content

Architecture Conventions

All the IW functions follow the general principles described below. If a function does not follow any of these principles, it is explicitly mentioned in the function description in this document and in the corresponding header file.
  • Implementation limitations:
    The library is designed to accelerate existing code and does not provide any general non-optimized code. A particular function may not have implementation for every variation of parameters that it uses. If the function returns an error, use your original code instead. Before developing processing based solely on this library, check that all required parameters are supported.
  • Status codes guidelines:
    • For functions returning status, 0 value means that the operation completed successfully.
    • Every status with value above or equal to 0 is a warning, which means that the function worked and completed its task, but some potential issues may arise and you need to pay attention to them. In general, this can be ignored.
    • Every status with value below 0 is an error. It means that the function did not complete operation and your code should provide a fallback scenario.
    • C++ APIs of the IW library throw the
      object only for values below 0.
  • Memory allocation:
    Some functions use internal memory allocation for temporary data:
    • In C++ APIs, all allocations are handled automatically by the library.
    • In C APIs, you may need to release objects manually. Functions that allocate memory have
      in their names and always have a
      Use the
      function only if the
      function completed successfully. Otherwise, no memory is allocated.
  • Parameters handling:
    Processing functions do not allocate memory for the destination data. Allocate memory for all data before using a processing function.

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.