Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
Contents

GetLibVersion

Returns information about the active version of the Intel IPP signal processing software.

Syntax

const IppLibraryVersion* ippsGetLibVersion(void);
Include Files
ipps.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
Libraries:
ippcore.lib
,
ippvm.lib
Description
This function returns a pointer to a static data structure
IppLibraryVersion
that contains information about the current version of the Intel IPP software for signal processing. There is no need for you to release memory referenced by the returned pointer, as it points to a static variable. The following fields of the
IppLibraryVersion
structure are available:
major
Major number of the current library version.
minor
Minor number of the current library version.
majorBuild
Update number.
build
Build revision number.
targetCpu[4]
Intel® processor.
Name
Name of the current library version.
Version
Library version string.
BuildDate
Library version actual build date.
For example, if the library version is “9.0 ”, build revision number is “49671”, library name is “ippSP AVX2”, target CPU is processor with Intel® Advanced Vector Extensions 2 (Intel® AVX2) and build date is “Dec 7 2015”, then the fields in this structure are set as:
major
= 9,
minor
= 0,
Name
= “ippSP AVX2”,
Version
= “9.0.1 (r49671)”,
targetCpu[4]
=“h9”,
BuildDate
= “Dec 7 2015”
Each sub-library in the signal processing domain has its own similar function to retrieve information about the active library version. Version information functions for sub-libraries have the same interface as
ippsGetLibVersion
.
The following table provides the list of version information functions and respective header files where these functions are declared:
Function Name
Header File
ippGetLibVersion
ippcore.h
ippccGetLibVersion
ippcc.h
ippcvGetLibVersion
ippcv.h
ippchGetLibVersion
ippch.h
ippdcGetLibVersion
ippdc.h
ippvmGetLibVersion
ippvm.h
ippeGetLibVersion
ippe.h

Example

The following example shows how to use the
ippsGetLibVersion
function :
const IppLibraryVersion* lib; lib = ippsGetLibVersion(); printf("major = %d\n",lib->major); printf("minor = %d\n",lib->minor); printf("majorBuild = %d\n",lib->majorBuild); printf("build = %d\n",lib->build); printf("targetCpu = %c%c%c%c\n",lib->targetCpu[0],lib->targetCpu[1],lib->targetCpu[2],lib->targetCpu[3]); printf("Name = %s\n", lib->Name); printf("Version = %s\n", lib->Version); printf("BuildDate = %s\n", lib->BuildDate);

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804