「ライブラリの基礎 - C++DLL」の版間の差分

== DllImport属性 ==

<code>DLLImport</code>属性は、DLLエントリポイントを定義する関数を記述することで、DLLファイルに定義された関数を呼び出すことができる。<br>

  [ DllImport( "DLL名" ) ]

<br>

また、DLLファイルに定義された関数を、関数名または序数で指定するには、<code>DllImport</code>属性の<code>EntryPoint</code>フィールドを使用する。<br>

<br>

以下の例では、<code>EntryPoint</code>フィールドを使用して、<code>MessageBoxA</code>をMsgBoxAに置き換える方法を示している。<br>

  using System;

  using System.Runtime.InteropServices;

     internal static extern int MsgBoxA(IntPtr hWnd, string lpText, string lpCaption, uint uType);

  }

<br>

また、以下の例では、DLLファイルに定義された関数を序数で指定している。<br>

  [DllImport("DllName", EntryPoint = "Functionname")]

  [DllImport("DllName", EntryPoint = "#123")]  // 序数を使用するには、序数値の前にシャープ記号#を付ける必要がある

<br>

<code>DllImport</code>属性には、DLLファイル名を指定する以外にも、下表のような引数を与えることができる。<br>

以下の例では、呼び出し規約を適用する方法をCdeclとしている。<br>

これは、呼び出し元がスタックをクリーンアップするために使用する必要がある。<br>

  using System;

  using System.Runtime.InteropServices;

     }

  }

詳細は、以下のMSDNのWebサイトを参照すること。<br>

[https://msdn.microsoft.com/ja-jp/library/system.runtime.interopservices.callingconvention.aspx CallingConvention 列挙型 (System.Runtime.InteropServices) | MSDN]<br>

== StructLayout属性 ==

StructLayout属性とは、クラスまたは構造体のデータメンバを、メモリ内でどのように配置するかを表す。<br>

  [ StructLayout( LayoutKind列挙 ) ]

<br>

下表に、LayoutKind列挙子を示す。<br>

</center>

<br>

  [StructLayout( LayoutKind.Sequential )]

  public struct Position

     public double z;

  }

<br>

詳細は、以下のMSDNのWebサイトを参照すること。<br>

<br>

以下の例では、UInt32型はCLSに準拠しないため、<code>CLSCompliant(false)</code>と指定する必要がある。<br>

  [CLSCompliant( false )]

  public int SetValue( UInt32 value );

<br>

以下の例では、CLSCompliantAttribute属性をアセンブリ全体に適用する。<br>

  using System;

  [assembly: CLSCompliant(true)]

<br>

詳細は、以下のMSDNのWebサイトを参照すること。<br>

詳細は、以下のMSDNのWebサイトを参照すること。<br>

[https://msdn.microsoft.com/ja-jp/library/system.runtime.interopservices.marshalasattribute.aspx MarshalAsAttribute クラス (System.Runtime.InteropServices) | MSDN]<br>

  // パラメータへの適用

  public void M1([MarshalAs(UnmanagedType.LPWStr)]string msg)

     return "Hello World";

  }

<br><br>

</center>

<br>

  void Method([in] int[] array);

<br><br>

<center>

|-

|-

|-

|-

| SHORT (short) || short (System.Int16) ||  

| WORD (unsigned short) || ushort (System.UInt16) ||  

|-

|-

|-

| BOOL (long) || bool (System.Boolean) ||  

| CHAR (char) || 文字を渡すとき<br>char (System.Char)<br>文字を受け取るとき<br>StringBuilder ||  

|-

|-

|-

| LPCSTR (const char *, const char[])<br>LPCWSTR (const wchar_t *, const wchar_t[]) || 文字を渡すとき<br>string (System.String)<br>文字を受け取るとき<br>System.Text.StringBuilder ||  

|-

| FLOAT (float) || float (System.Single) ||  

|-

| DOUBLE (double) || double (System.Double) ||  

|}

</center>

<br><br>

<br>

  <syntaxhighlight lang="c++">

  // SampleDLL.h

  </syntaxhighlight>

<br>

次に、C# EXEからC++ DLLを呼び出す方法を記述する。<br>

<br>

     class Program

     {

       private static extern int SampleFunc01(int a);

   

       private static extern double SampleFunc02(double a);

   

  }

  </syntaxhighlight>

例えば、C++ DLLから次のような関数がエクスポートされているとする。<br>

  <syntaxhighlight lang="c++">

<br>

なお、Windows APIではBOOL型の実体はLONG型なので、.NET Frameworkではboolの代わりにintを指定することも可能である。<br>

このセクションでは、C# EXEからC++ DLLへ配列を渡す方法を記載する。<br>

<br>

  }

  </syntaxhighlight>

C++ DLLの作成方法は[[ライブラリの基礎 - DLLの作成(C/C++/MFC)|ライブラリの基礎 - DLLの作成(C/C++/MFC)]]を参照する。<br>

<br>

       }

     }

  }

  </syntaxhighlight>

<br>

<br>

  <syntaxhighlight lang="c++">

  // SampleDLL.h

  </syntaxhighlight>

<br>

次に、C# EXEからC++ DLLを呼び出す方法を記述する。<br>

<br>

       /// <param name="a">4 バイト符号付き整数を指定します。</param>

       /// <returns>倍精度浮動小数を返します。</returns>

       private static extern double SampleFunc01(int a);

   

       // C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する

       private static extern void SampleFunc02(int a, string str);

   

       // C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する

       private static extern void SampleFunc03(int a, StringBuilder str);

  }

  </syntaxhighlight>

C++ DLLの作成方法は[[ライブラリの基礎 - DLLの作成(C/C++/MFC)|ライブラリの基礎 - DLLの作成(C/C++/MFC)]]を参照する。<br>

<br>

  }

  </syntaxhighlight>

<br>

<br>

  // SampleDLL.h

   

  int __stdcall SampleCallback(int handle, int lPalam);

<br>

  // SampleDll.cpp

   

     return iRet;

  }

<br>

  // モジュール定義ファイル

  // SampleDll.def

           ; 公開する関数名をリストアップ

           SampleCallback  @1

<br>

次に、C# EXEからC++ DLLを呼び出す方法を記述する。<br>

<br>

以下の例では、ManagedCallBackというデリゲートを宣言している。<br>

C++ DLLのSampleCallBack関数にデリゲートを引数として渡すことで、既知のコールバック形式に自動的に変換される。<br>

  using System;

  using System.Runtime.InteropServices;

     class Program

     {

         private static extern int SampleCallback(ManagedCallBack CallBack, int lPalam);

     }

  }

== トラブル対処 ==