Xil_ExceptionRegisterHandler - Xil_ExceptionRegisterHandler - 2026.1 English - UG643

Standalone Library Documentation: BSP and Libraries Document Collection (UG643)

Document ID
UG643
Release Date
2026-06-23
Version
2026.1 English

Makes the connection between the Id of the exception source and the associated handler that is to run when the exception is recognized.

The argument provided in this call as the DataPtr is used as the argument for the handler when it is called.

Prototype

void Xil_ExceptionRegisterHandler(u32 Exception_id, Xil_ExceptionHandler Handler, void *Data);

Parameters

The following table lists the Xil_ExceptionRegisterHandler function arguments.

Table 1. Xil_ExceptionRegisterHandler Arguments
Name Description
Exception_id contains the 32 bit ID of the exception source and must be XIL_EXCEPTION_ID_INT or be in the range 0 to XIL_EXCEPTION_ID_LAST. See xil_exception.h for further information.
Handler handler function to be registered for exception
Data a reference to data that is passed to the handler when it is called.