Specifications

alt_dma_rxchan_reg()
Prototype
int alt_dma_rxchan_reg (alt_dma_rxchan_dev* dev)
Commonly Called By
C/C++ programs
Device drivers
Thread-safe
No.
Available from ISR
No.
Include
<sys/alt_dma_dev.h>
Description
The alt_dma_rxchan_reg() function registers a DMA receive channel with the system.
After it is registered, a device can be accessed using the functions described in “Using DMA Devices” in
the "Developing Programs Using the Hardware Abstraction Layer" section.
System behavior is undefined in the event that a channel is registered with a name that conflicts with an
existing channel.
The alt_dma_rxchan_reg() function is not thread-safe if other threads are using the channel list at the
time that alt_dma_rxchan_reg() is called. Call alt_dma_rxchan_reg() only in the following
circumstances:
• When running in single-threaded mode.
• From a device initialization function called by alt_sys_init(). alt_sys_init() may only be called
by the single-threaded C startup code.
Return
The return value is zero upon success. A negative return value indicates failure.
Related Information
• Developing Programs Using the Hardware Abstraction Layer on page 6-1
• alt_dma_rxchan_close() on page 14-13
• alt_dma_rxchan_depth() on page 14-12
• alt_dma_rxchan_open() on page 14-15
• alt_dma_rxchan_prepare() on page 14-16
• alt_dma_txchan_close() on page 14-18
• alt_dma_txchan_ioctl() on page 14-19
• alt_dma_txchan_open() on page 14-20
NII5V2
2015.05.14
alt_dma_rxchan_reg()
14-17
HAL API Reference
Altera Corporation
Send Feedback