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

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

2.3.9. aocl_mmd_set_status_handler

aocl_mmd_set_status_handler関数は、オープンのデバイスの動作ステータスハンドラーを設定します。
動作ステータスハンドラーは、次の状況下で呼び出されます。
  • 動作が正常に完了し、ステータスが 0 の場合
  • 動作がエラーで完了し、ステータスが負の値になった場合

構文

int aocl_mmd_set_status_handler( int handle,
                                 aocl_mmd_status_handler_fn fn,
                                 void* user_data );

関数の引数

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

  2. fn—ステータスの更新が発生した際に呼び出されるコールバック関数です。 fn引数の型はaocl_mmd_status_handler_fnで、次のとおり定義されます。
    type void (*aocl_mmd_status_handler_fn)( int handle, void* user_data, aocl_mmd_op_t op, int status );

  3. user_datavoid*型のユーザーが提供したデータで、コールされるとfnに渡されます。

戻り値

関数が正常に実行された場合、戻り値は 0 です。

関数が正常に実行されなかった場合、負の戻り値はエラーを示します。