Intel® oneAPI DPC++/C++ Compiler Developer Guide and Reference

ID 767253
Date 7/13/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Use Intel® Libraries with Microsoft Visual Studio*

You can use the compiler with the following Intel® Libraries, which may be included as a part of the product:

  • Intel® oneAPI Data Analytics Library (oneDAL)
  • Intel® Integrated Performance Primitives (Intel® IPP)
  • Intel® oneAPI Threading Building Blocks (oneTBB)
  • Intel® oneAPI Math Kernel Library (oneMKL)

Use the property pages to specify Intel Libraries to use with the selected project configuration. The functionality supports Intel® C++, Intel® oneAPI DPC++, and Microsoft Visual C++* project types.

To specify Intel Libraries, select Project > Properties. In Configuration Properties, select Intel Libraries for oneAPI, then do the following:

  1. To use oneDAL change the Use oneDAL settings as follows:
    • No: Disable Use of oneDAL.
    • Default Linking Method: Use parallel dynamic oneDAL libraries.
    • Multi-threaded Static Library: Use parallel static oneDAL libraries.
    • Single-threaded Static Library: Use sequential static oneDAL libraries.
    • Multi-threaded DLL: Use parallel dynamic oneDAL libraries.
    • Single-threaded DLL: Use sequential dynamic oneDAL libraries.
  2. To use Intel® Integrated Performance Primitives, change the Use Intel® IPP settings as follows:
    • No: Disable use of Intel® IPP libraries.
    • Default Linking Method: Use dynamic Intel® IPP libraries.
    • Static Library: Use static Intel® IPP libraries.
    • Dynamic Library: Use dynamic Intel® IPP libraries.
  3. To use oneTBB in your project, change the Use oneTBB settings as follows:
    • No: Disable use of oneTBB libraries.
    • Use oneTBB: Set to Yes to use oneTBB in the application.
    • Instrument for use with Analysis Tools: Set to Yes to analyze your release mode application (not required for debug mode).
  4. To use oneMKL in your project, change the Use oneMKL property settings as follows:
    • No: Disable use of oneMKL libraries.
    • Parallel: Use parallel oneMKL libraries.
    • Sequential: Use sequential oneMKL libraries.
    • Cluster: Use cluster libraries.

    The target platform of an Intel® oneAPI DCP++ project is set to x64, so a final selection appears: Use interface. If selected, the corresponding ilp oneMKL libraries are added to the linker command line. Additionally, the MKL_ILP64 preprocessor definition is added to the compiler command line. If you do not make this selection, the Ip oneMKL libraries are used.

Additional settings for use with the Microsoft Visual C++* Platform Toolset are available on the Intel Libraries for oneAPI category, found at Tools > Options.

Change the Selected Intel Libraries for oneAPI

If you have installed multiple versions of the Intel Libraries for oneAPI, you can specify which version to use with the Microsoft Visual C++* compiler. To do this:

  1. Select Tools > Options.

  2. In the left pane, select Intel Compilers and Libraries > Intel Libraries for oneAPI.

  3. Select the desired library version from the drop-down boxes in the right pane.

For more information, see the Intel® oneAPI Data Analytics Library (oneDAL), Intel® Integrated Performance Primitives (Intel® IPP), Intel® oneAPI Threading Building Blocks (oneTBB), and Intel® oneAPI Math Kernel Library (oneMKL) documentation.

Product and Performance Information

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

Notice revision #20201201