Microsoft .NET Frameworkでの注意点

開発環境に「Microsoft .NET Framework」（以下「.NET環境」）を使用する場合は、構造体や定数の定義などが異なります。 詳細については、以下のAPIリファレンスを参照してください。

.NET環境の対応バージョンは4.0以降です。

構造体定義​

.NET環境では、構造体はvalue structで定義されます。各構造体は、メンバ変数の型がC++/CLI形式に変更されますが、メンバ変数名や構造体定義については変更されません。 ただし、一部の構造体では例外的な処理を行っています。

(1) StMPXAPIVersion構造体（APIのバージョン情報）のメンバ変数APIVersionは、以下のように文字列で定義されています。

(2) StMPXDeviceInfo構造体（MicroPeckerXのデバイス情報）のメンバ変数Modelは、以下のように文字列で定義されています。

Visual Studioでの利用​

C#またはVB.NETで本SDKを使用する場合は、Visual Studioのプロジェクトにて、以下のラッパDLLファイルを参照してください。

32bit版での設定例​

開発環境に「Microsoft Visual C++ 2019」を使用する場合の設定手順例を以下に示します。

1. 「ソリューション エクスプローラー」の「参照」を右クリックします。
   

2. 表示されるコンテキストメニューから「参照の追加」を選択します。
   

3. 「参照マネージャー」ダイアログの「参照」ボタンをクリックし、表示されるファイルダイアログから「MPXCtrldotNET40Free.dll」を選択します。
   

4. 「参照マネージャー」ダイアログの参照ファイル一覧に「MPXCtrldotNET40Free.dll」が表示され、チェックボックスにチェックが入っていることを確認して「OK」ボタンをクリックします。
   

5. 「ソリューション エクスプローラー」の「参照」のリストに、「MPXCtrldotNET40Free.dll」が追加されたことを確認します。
   

実行時に必要なDLL​

ラッパDLLを参照するだけでは実行できません。実行時には、実行ファイルと同じフォルダにネイティブDLLも配置してください。

詳細な同梱物は 製品構成 を参照してください。

ビット数を必ず一致させる​

• 32bitプロセスに64bit DLLを読み込ませない
• 64bitプロセスに32bit DLLを読み込ませない
• AnyCPUを使う場合も、実行環境に合わせて参照DLL/配置DLLを統一する

一致していない場合、BadImageFormatException や DLLロード失敗が発生します。

C#での配列メンバー初期化​

.NETラッパの構造体には、配列メンバーを持つものがあります。
new で配列だけ確保した後、各要素の配列メンバーも明示的に初期化してください。

// CAN Slot/Log の初期化例
var slots = new StMPXCANSlot[28];
for (int i = 0; i < slots.Length; i++)
{
    slots[i].Increment = new byte[64];
    slots[i].Frame.Data = new byte[64];
}

var canLogs = new StMPXCANLog[1024];
for (int i = 0; i < canLogs.Length; i++)
{
    canLogs[i].Data = new byte[64];
}

// LIN Sim/Log の初期化例
var masterSims = new StMPXLINMasterSim[2];
for (int i = 0; i < masterSims.Length; i++)
{
    masterSims[i].Item = new StMPXLINMasterSimItem[64];
}

StMPXLINSlaveSim slaveSim = new StMPXLINSlaveSim();
slaveSim.Item = new StMPXLINSlaveSimItem[64];

var linLogs = new StMPXLINLog[1024];
for (int i = 0; i < linLogs.Length; i++)
{
    linLogs[i].Data = new byte[64];
}

未初期化のままアクセスすると、NullReferenceException の原因になります。