8月 | 2012 | 旅の記録

この記事の目的は「アンマネージド DLL に親しむ」です。

C/C++ で DLL を作る
C# で DLL 関数を呼び出す
文字列を扱う

C/C++ で DLL を作る

C で書かれた次の資産 arithmetic.c を，C# のプログラムから使いたいとします。

// arithmetic.c

int add(int a, int b)
{
    return a + b;
}

これを EXE ではなく DLL としてコンパイルすれば，C# のプログラムから DLL を読み込むことで，add 関数を呼び出すことができます。ただし，正しく DLL 化するには少々の細工が必要です。実際に，正しく細工を施した次のコードを DLL としてコンパイルしてみてください。

// arithmetic.c

__declspec(dllexport) int __stdcall add(int a, int b);

__declspec(dllexport) int __stdcall add(int a, int b)
{
    return a + b;
}

※ VC++ で DLL としてコンパイルするには，[表示] – [(プロジェクト名) のプロパティ] から，[構成プロパティ] – [全般] – [構成の種類] を [ダイナミックライブラリ (.dll)] に設定してください。

※ BCC で DLL としてコンパイルするには，-WD オプションを指定してください。

C++ としてコンパイルする場合には，extern "C" を付加する必要があります。関数のオーバーロードの関係で，関数名がめちゃくちゃに変えられてしまうのを防ぐためです。

// arithmetic.cpp

extern "C" __declspec(dllexport) int __stdcall add(int a, int b);

extern "C" __declspec(dllexport) int __stdcall add(int a, int b)
{
    return a + b;
}

__declspec(dllexport) は，関数のエクスポートに必要なキーワードです。関数のエクスポートとは，関数を他のプログラムから利用できるように公開することです。

__stdcall は呼び出し規約といい，関数の呼び出し方を決定するために必要なキーワードです。よく使われる呼び出し規約には __stdcall 以外に __cdecl などがあります。__stdcall を修飾する関数はプロトタイプ宣言が必要とのことです。

__stdcall (MSDN): http://msdn.microsoft.com/ja-jp/library/zxk0tw93.aspx

C でも C++ でも通用する書き方として，次のようなマクロ定義をしたコードをお勧めします。ここで __cplusplus は，C++ モードでコンパイラが自動的に定義するマクロ定数です。

// arithmetic.c または arithmetic.cpp

#ifdef __cplusplus
#define DLLEXPORT extern "C" __declspec(dllexport)
#else
#define DLLEXPORT __declspec(dllexport)
#endif

DLLEXPORT int __stdcall add(int a, int b);

DLLEXPORT int __stdcall add(int a, int b)
{
    return a + b;
}

C# で DLL 関数を呼び出す

さて，一方の DLL を呼び出す側ですが，C# のコードは次のようにします。

// Program.cs

using System;
using System.Runtime.InteropServices;

class Program
{
    [DllImport("arithmetic.dll")]
    static extern int add(int a, int b);

    static void Main()
    {
        Console.WriteLine("2 + 3 = {0}", add(2, 3));
        Console.WriteLine("4 + 5 = {0}", add(4, 5));
    }
}

arithmetic.dll 内にある add() を関数を読み込むために，次の 2 行からなる宣言を行っています。

    [DllImport("arithmetic.dll")]
    static extern int add(int a, int b);

DllImport 属性 (System.Runtime.InteropServices 名前空間) は，関数が指定したアンマネージド DLL から読み込まれることを示します。続く修飾子 static extern は決まり文句です。戻り値，関数名，引数リストは，型が C と C# に共通である限り，元の関数プロトタイプをそのまま写せば OK です。

さて，このプログラムをビルドして，生成された実行ファイルと同じディレクトリに DLL ファイルを置けば準備完了です。プログラムをコマンドプロンプトで走らせてみてください。

文字列を扱う

文字列を受け渡しする次の mystrcpy() 関数を DLL 化します。

// strutils.c

#include <string.h>

#ifdef __cplusplus
#define DLLEXPORT extern "C" __declspec(dllexport)
#else
#define DLLEXPORT __declspec(dllexport)
#endif

DLLEXPORT void __stdcall mystrcpy(char *dest, const char *src);

DLLEXPORT void __stdcall mystrcpy(char *dest, const char *src)
{
    strcpy(dest, src);
}

これを C# から呼び出すためには，次のようにします。

// Program.cs

using System;
using System.Runtime.InteropServices;
using System.Text;

class Program
{
    [DllImport("strutils.dll")]
    static extern void mystrcpy(StringBuilder dest, string src);

    static void Main()
    {
       StringBuilder dest= new StringBuilder(1024);
       string src = "this is a test.";
       mystrcpy(dest, src);
       Console.WriteLine(dest.ToString());
    }
}

char * は System.Text.StringBuilder，const char * は string に対応付けられます。StringBuilder を使用する際は，new StringBuilder(1024) のように，十分な領域を確保する必要があります (*1)。

C の型	C# の型
`const char *`	`string`
`char *`	`System.Text.StringBuilder`

関数宣言の頭に unsafe を指定すれば，ポインタをポインタのまま残すことも可能です。

その他の型の対応については，次のサイトが参考になります。

.NET TIPS Win32 APIやDLL関数を呼び出すには？ – @IT: http://www.atmarkit.co.jp/fdotnet/dotnettips/024w32api/w32api.html

(*1) コメントでご指摘いただき，new StringBuilder() を new StringBuilder(1024) に訂正，その旨補足しました (2012-08-20)。

旅の記録

Monthly Archives: 8月 2012

C/C++ で作った DLL を C# で使う

C/C++ で DLL を作る

C# で DLL 関数を呼び出す

文字列を扱う