Jump to main content

##

# 1.2.6.12 SYS_DMA_CHANNEL_CALLBACK Typedef

## C

    typedef void (*SYS_DMA_CHANNEL_CALLBACK) (SYS_DMA_TRANSFER_EVENT event, uintptr_t contextHandle);

## Summary

Pointer to a DMA Transfer Event handler function.

## Description

This data type defines a DMA Transfer Event Handler Function.

A DMA client must register a transfer event handler function of this type to receive transfer related events from the DMA System Service.

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

If the event is SYS_DMA_TRANSFER_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 consider helpful or necessary to identify the client context object associated with the channel of the DMA that generated the event.

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

## Remarks

None.