ippGetStatusString

Translates a status code into a message.

Syntax

const char* ippGetStatusString(IppStatus stsCode);

Parameters

stsCode

Code that indicates the status type (see table "Error Status Values and Messages").

Description

The function ippGetStatusString is declared in the ippcore.h file. This function returns a pointer to the text string associated with a status code of type IppStatus. Use this function to produce error and warning messages for users. The returned pointer is a pointer to an internal static buffer and need not be released.

The example below shows how to use the function ippGetStatusString. If you call an Intel IPP function, in this case, ippsAddC_16s_I 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 the Function ippGetStatusString

void statusinfo(void) {

       IppStatus st = ippsAddC_16s_I (3, 0, 0);

       printf(“%d : %s\n”, st, ippGetStatusString(st));

Output:

    -8, Null Pointer Error