OpenNI 1.5.4: Error codes


Error codes

OpenNI errors mechanism is error codes. Every function that might fail has a return value of type XnStatus. A value of XN_STATUS_OK means the function has succeeded. Any other value means some kind of failure has occurred.

For additional error information, one may use the function xnGetStatusString(), which returns a human readable description of the error, in English.

Some basic error codes can be found in file XnStatusCodes.h.

A normal usage of the error mechanism is checking if an error has occurred, and if so, print a message and close the application:

xn::Context context;
XnStatus nRetVal = context.Init();
if (nRetVal != XN_STATUS_OK)
    printf("Failed to initialize OpenNI: %s\n", xnGetStatusString(nRetVal));
Generated on Wed May 16 2012 10:16:06 for OpenNI 1.5.4 by   doxygen