ippGetStatusString

Translates a status code into a message.

Syntax

const char* ippGetStatusString(IppStatus StsCode);

Parameters

StsCode

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

Description

The function ippGetStatusStringis declared in the ippcore.h file. 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.

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.

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

Using Status Information Function

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