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

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

2.3.3. aocl_mmd_open

aocl_mmd_open関数は、指定されたデバイスを開き、初期化します。

構文

int aocl_mmd_open( const char* name );

関数の引数

name—この関数は、このconst char*文字列と一致する名前でボードを開きます。名前は、通常、AOCL_MMD_BOARD_NAMESオフライン情報で指定されたものと一致します。

OpenCL™ランタイムは、まずAOCL_MMD_BOARD_NAMESオフライン情報を照会してオープン可能なボードを識別します。次に、aocl_mmd_openを呼び出し、各ボード名を引数として使用することで、すべての可能なデバイスをオープンしようとします。

重要: 名前は C スタイルの NULLで終了する ASCII 文字列でなければなりません。

戻り値

aocl_mmd_open()が正常に実行されなかった場合、戻り値はボードのハンドルとして機能する正の整数になります。

aocl_mmd_open()が正常に実行されない場合、負の戻り値はエラーを表示します。エラーが発生した場合、OpenCL ランタイムは他の既知のデバイスをオープンします。したがって、オープンコールが正常に行われない場合、MMD レイヤーがアプリケーションを終了しないことが必須です。