インテル® FPGA SDK for OpenCL: カスタム・プラットフォーム・ツールキット・ユーザーガイド

ID 683085
日付 10/31/2016
Public
ドキュメント目次

2.3.7. aocl_mmd_copy

aocl_mmd_copy関数は、シングル・インターフェイスでのコピー動作です。

構文

int aocl_mmd_copy( int handle, aocl_mmd_op_t op, size_t len, aocl_mmd_interface_t intf, size_t src_offset, size_t dst_offset );

関数の引数

  1. handleaocl_mmd_open()コールで入手したボードへのハンドルを表す正のint値です。

  2. op—操作の進行状況を追跡するために使用される型aocl_mmd_op_tのオペレーション・オブジェクトです。opが NULL の場合、コールはブロックされ、動作が完了した後にのみ返されます。
    注:

    aocl_mmd_op_tは次とおり定義されます。

    typedef void* aocl_mmd_op_t;

  3. len—関数が転送するデータのバイト単位のサイズです。型size_tlenを宣言します。

  4. intfaocl_mmd_readがアクセスしているインターフェイスへのハンドルです。例えば、グローバルメモリーにアクセスする場合のハンドルは、requested_info_id引数がAOCL_MMD_MEMORY_INTERFACEの際に返す列挙値aocl_mmd_get_info()です。interface 引数はaocl_mmd_interface_t型で、次のいずれかの値を取ります。
    名前 説明
    AOCL_MMD_KERNEL カーネル・インタフェース内のインタフェースの制御です。
    AOCL_MMD_MEMORY デバイスメモリーへのデータ・インターフェイスです。
    AOCL_MMD_PLL リコンフィグレーションが可能な PLL のためのインターフェイスです。

  5. src_offset—データ転送が開始が生じるソース・インターフェイス内のsize_tバイトオフセットです。

  6. dst_offset—データ転送が開始されるデスティネーション・インタフェース内のsize_tバイトオフセットです。

戻り値

コピー動作が成功した場合、戻り値は 0 です。

コピー動作が失敗した場合、負の戻り値はエラーを示します。