インターフェイスの使用

インターフェイスの一般的な使用法は、次のとおりです(例:Natural サブプログラムの呼び出し):

  1. Natural バイナリの場所を決定します。

  2. Natural Native Interface ライブラリをロードします。

  3. nni_get_interface を呼び出して、インターフェイスインスタンスを取得します。

  4. nni_initialize を呼び出して、Natural セッションを初期化します。

  5. nni_logon を呼び出して、特定の Natural ライブラリにログオンします。

  6. nni_create_parm または関連する関数を呼び出して、パラメータセットを作成します。

  7. 各パラメータについて、次の手順を実行します。

    • nni_init_parm 関数の 1 つを呼び出して、パラメータを正しいタイプに初期化します。

    • nni_put_parm 関数の 1 つを呼び出して、パラメータに値を割り当てます。

    • nni_get_parm_info を呼び出して、parameter_description 構造を作成します。

  8. nni_callnat を呼び出して、サブプログラムを呼び出します。

  9. 変更可能な各パラメータについて、次の手順を実行します。

    • nni_get_parm 関数の 1 つを呼び出して、パラメータ値を取得します。

  10. nni_delete_parm を呼び出して、パラメータ構造を解放します。

  11. nni_uninitialize を呼び出して、Natural セッションを初期化解除します。

  12. nni_logoff を呼び出して、前のライブラリに戻ります。

  13. nni_free_interface を呼び出して、インターフェイスインスタンスを解放します。

インターフェイスの使用法を示した C プログラムの例 nnisample.c は、<install-dir>/natural/samples/sysexnni にあります。