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.

A code example 3-3 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