Nios® V プロセッサー・ソフトウェア開発者ハンドブック

ID 743810
日付 7/08/2024
Public
ドキュメント目次

16.1.1.16. alt_dma_rxchan_reg()

プロトタイプ

int alt_dma_rxchan_reg (alt_dma_rxchan_dev* dev)

一般的な呼び出し元

C/C++ プログラム

デバイスドライバー

スレッドセーフ

いいえ

ISRから利用可能

いいえ

インクルード

<sys/alt_dma_dev.h>

説明

alt_dma_rxchan_reg() 関数は、DMA 受信チャネルをシステムに登録します。

登録後、「ハードウェア抽象化レイヤーを使用したプログラムの開発」セクションの「DMA デバイスの使用」で説明されている関数を使用してデバイスにアクセスできます。

チャネルが既存のチャネルと競合する名前で登録されている場合、システムの動作は未定義です。

alt_dma_rxchan_reg() 関数の呼び出し時に他のスレッドがチャネルリストを使用している場合、 alt_dma_rxchan_reg() 関数はスレッドセーフではありません。alt_dma_rxchan_reg() は、次の状況でのみ呼び出します。

  • シングル・スレッド・モードで実行している場合。
  • alt_sys_init() によって呼び出されるデバイス初期化関数から。alt_sys_init() は、シングルスレッドの C スタート・アップ・コードによってのみ呼び出すことができます。

戻り値

成功時の戻り値は 0 です。負の戻り値は失敗を示します。