Analog Devices VisualDSP++ 5.0 Service Manual page 289

Arguments
Table 6-2. Adi_dma_Open
Argument
ManagerHandle
ChannelID
*ClientHandle
*pChannelHandle
Mode
DCBServiceHandle
ClientCallback
Return Value
The function returns
fully opened; any other value indicates an error. Possible errors include:
ADI_DMA_RESULT_ALL_IN_USE
ADI_DMA_RESULT_CANT_HOOK_INTERRUPT
VisualDSP++ 5.0 Device Drivers and System
Services Manual for Blackfin Processors
Explanation
Handle to the DMA manager
enumeration value. See
ADI_DMA_CHANNEL_ID
"ADI_DMA_CHANNEL_ID" on page
Identifier defined by the client. The DMA manager includes this identi-
fier in all DMA manager-initiated communication with the client, spe-
cifically in calls to the callback function.
Pointer to a client-provided location where the DMA manager stores an
identifier defined by the DMA manager. All subsequent communica-
tion initiated by the client to the DMA manager for this channel
includes the handle to specify the channel to which it is referring.
enumeration value specifying the data transfer mode
ADI_DMA_MODE
used by the opened DMA channel. See
page 6-59.
Handle to the deferred callback service used for the given channel. A
value of NULL means that deferred callbacks are not used and all call-
backs occur at DMA interrupt time.
Address of a callback function defined by the application. The value
passed for the
ClientHandle
application when the channel was opened.
ADI_DMA_RESULT_SUCCESS
DMA Manager
6-58.
"ADI_DMA_MODE" on
parameter is the value supplied by the
if the channel was success-
All channel memory is in use.
System cannot hook a DMA data or error
interrupt.
6-49