AIRegisterDMACallback

Syntax

#include <revolution/ai.h>

typedef void (*AIDCallback)(void);

AIDCallback AIRegisterDMACallback(AIDCallback callback);

Arguments

callback	Callback function for the AI DMA interrupt (`AIDINT`).

Return Values

Returns a pointer to the old callback function already registered. Returns NULL if no callback function has been registered.

Description

The AIRegisterDMACallback function registers the callback function to be invoked for the AI-DMA interrupt (AIDINT). The existing callback function is replaced by the new callback function unconditionally. The callback function is deleted if NULL is specified for an argument and no callback function will ever be called in response to an AI DMA interrupt.

Note: The AX library calls this function from inside the initialization function (for example, from inside AXInit). Because of this, any AI DMA interrupt callback set using this function before the AX library initialization function was called will be overwritten by the AX callback. If you are using an original AI DMA interrupt callback, be sure to set it using this function only after calling the AX library initialization function.

Revision History

2008/12/26 Added a note about the AI DMA interrupt callback.
2006/03/01 Initial version.