Intel® C++ Compiler 16.0 User and Reference Guide

_GFX_get_last_error

Returns the most recent error code detected by the Intel® Graphics Technology runtime. This topic only applies to Intel® 64 and IA-32 architectures targeting Intel® Graphics Technology.

Syntax

int _GFX_get_last_error();

Parameters

None

Description

This function returns the most recent error code detected by the Intel® Graphics Technology runtime, even if any recent GFX API calls were successful and finished with the status code GFX_SUCCESS. This behavior helps detect if any recent API calls resulted in an error.

Some GFX API functions do not report an error code. Examples are GfxImage2D or GfxSharedImage2D objects, or functions that return handles to internal objects. If any error occurs during those or any other GFX API functions, you can use _GFX_get_last_error to get the error code. This function may be particularly useful to diagnose errors after complex scenarios involving multiple GFX API calls.

This function returns a thread-local error code variable. Each thread tracks its own error status, but some non-recoverable errors, such as driver initialization failures, are set globally for the duration of program execution, and are therefore not visible to any thread that subsequently calls _GFX_get_last_error.

Return Values

The most recent run time error detected by the Intel® Graphics Technology runtime.