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

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

2.3.2. aocl_mmd_get_info

aocl_mmd_get_info関数は、requested_info_id引数に指定されたボードに関する情報を取得します。

構文

int aocl_mmd_get_info( int handle, aocl_mmd_info_t requested_info_id, size_t param_value_size, void* param_value, size_t* param_size_ret );

関数の引数

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

  2. requested_info_id—コール元に返すデバイス情報が示すaocl_mmd_offline_info_t型の列挙値です。
    表 18.  requested_info_id 引数での正の列挙値
    名前 説明
    AOCL_MMD_NUM_KERNEL_INTERFACES カーネル・インターフェイスの数です。 int
    AOCL_MMD_KERNEL_INTERFACES カーネル・インターフェイスです。 int*
    AOCL_MMD_PLL_INTERFACES カーネル・クロック・ハンドルです。 int*
    AOCL_MMD_MEMORY_INTERFACE グローバルメモリー・ハンドルです。 int
    AOCL_MMD_TERMPERATURE 温度測定です。 float
    AOCL_MMD_PCIE_INFO PCIe®情報です。 char*
    AOCL_MMD_BOARD_NAME ボードの名前です。 char*
    AOCL_MMD_BOARD_UNIQUE_ID 特有ボード ID です。 char*

  3. param_value_sizeparam_valueフィールドのバイト単位のサイズです。size_t値は、列挙が定義で示す予期される応答の型のサイズと一致していなければなりません。

    例えば、AOCL_MMD_TEMPERATUREfloat型の値を返す場合、param_value_sizesizeof (float)に設定します。param_size_ret引数で返されるバイト数と同じ数が表示されなければなりません。

  4. param_value—返された情報を受信する変数へのvoid*ポインターです。

  5. param_size_ret—返されるデータのバイト数を受信するsize_t*型のポインター引数です。

戻り値

負の戻り値はエラーを示します。