---
name: "rtcSetDeviceErrorFunction"
section: "3"
platform: "linux"
package: "libembree-dev"
version: "4.3.3+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rtcSetDeviceErrorFunction"
---

# rtcSetDeviceErrorFunction(3)

### NAME

-

  ```
  rtcSetDeviceErrorFunction - sets an error callback function for the device
  ```

### SYNOPSIS

-

  ```
  #include <embree4/rtcore.h>
  typedef void (*RTCErrorFunction)(
    void* userPtr,
    RTCError code,
    const char* str
  );
  void rtcSetDeviceErrorFunction(
    RTCDevice device,
    RTCErrorFunction error,
    void* userPtr
  );
  ```

### DESCRIPTION

Using the `rtcSetDeviceErrorFunction` call, it is possible to set a callback function (`error` argument) with payload (`userPtr` argument), which is called whenever an error occurs for the specified device (`device` argument).

Only a single callback function can be registered per device, and further invocations overwrite the previously set callback function. Passing `NULL` as function pointer disables the registered callback function.

When the registered callback function is invoked, it gets passed the user-defined payload (`userPtr` argument as specified at registration time), the error code (`code` argument) of the occurred error, as well as a string (`str` argument) that further describes the error.

The error code is also set if an error callback function is registered.

### EXIT STATUS

On failure an error code is set that can be queried using `rtcGetDeviceError`.

### SEE ALSO

\[rtcGetDeviceError\]