1.29.8.23 DMAC_CHANNEL_CALLBACK Typedef

C

typedef void (*DMAC_CHANNEL_CALLBACK) (DMAC_TRANSFER_EVENT status, uintptr_t contextHandle);

Summary

Pointer to a DMAC Transfer Event handler function.

Description

This data type defines a DMAC Transfer Event Handler Function. A DMAC PLIB client must register a transfer event handler function of this type to receive transfer related events from the PLIB.

If the event is DMAC_TRANSFER_EVENT_COMPLETE, this means that the data was transferred successfully.

If the event is DMAC_TRANSFER_EVENT_ERROR, this means that the data was not transferred successfully.

The contextHandle parameter contains the context handle that was provided by the client at the time of registering the event handler. This context handle can be anything that the client considers helpful or necessary to identify the client context associated with the DMAC channel that generated the event.

The event handler function executes in an interrupt context of DMAC. It is recommended to the application not to perform process intensive operations with in this function.

Remarks

None.