Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public

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

Document Table of 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”

NOTE:

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);