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

ippGetStatusString

Translates a status code into a message.

Syntax

const char* ippGetStatusString(IppStatus StsCode);

Include Files

ippcore.h

Parameters

StsCode

Code that indicates the status type (see Table Status Codes and Messages)

Description

This function returns a pointer to the text string associated with a status code StsCode. Use this function to produce error and warning messages. The returned pointer is a pointer to an internal static buffer and needs not be released.

The status information function translates this code into the corresponding message Null Pointer Error:

Example

A code example below shows how to use the ippGetStatusString function. If you call an Intel IPP function, in this example ippiSet_8u_C1R, with a NULL pointer, it returns an error code -8.

void statusInfo( void ) { 
	IppiSize roi = {0}; 
	IppStatus st = ippiSet_8u_C1R(3, 0, 0, roi ); 
	printf( " %d : %s\n", st, ippGetStatusString( st )); 
}

Output:

    
-8, Null Pointer Error