Delphi Programming / Object Pascal
サイトのトップページへ リンクのページへ ロゴマーク
[掲載 2022年09月23日] [更新 2022年09月23日] Delphi 一般・その他
DLL の作成
動作確認等 Windows 10 ビルド 19043 Pro 64 bit + Delphi XE5(UP2) Pro VCL-32
[整理番号 - 1178]







DLL の作成


Delphi で DLL を新規に作成する手順と,簡単なサンプル作成の記事です.



[備考]
32 ビットの DLL は,64 ビットの EXE では使用できません.64 ビットの DLL は 32 ビットの EXE では使用できません.




01_DLL を新規作成


[ファイル] [新規作成] で [その他] を選択します.起動したダイアログの左ペインの [Delphi プロジェクト] を選択して,右ペインの [ダイナミックリンクライブラリ],つまり,DLL を選択します.



図1
[新規作成] [その他] のダイアログ
  • 左ペインの
    [Delphi プロジェクト] を選択
  • 右ペインの
    [ダイナミックリンクライブラリ] を選択

プロジェクトのコードを以下のようにします.
この DLL は,整数の加算と実数の乗算の関数だけを実装しています.

stdcall は,関数類の引数などの内部処理の,Pascal における呼び出し規約です.Windows API でもデファクトスタンダードの呼出規約となっています.DLL 内の関数を使用する際の一種の「おまじない」ぐらいに考えても差支えありません.
exports には,外部から使用可能な関数名を列挙します.ここに列挙した関数や手続きだけが外部から利用できます.



リスト1
library SampleDLL;

uses
  System.SysUtils,
  System.Classes;

function AddValue(Val1, Val2: Integer): Integer; stdcall;
begin
  Result := Val1 + Val2;
end;

function MulValue(Val1, Val2: Double): Double; stdcall;
begin
  Result := Val1 * Val2;
end;

exports
  AddValue,
  MulValue;

begin
end.


[ファイル] [プロジェクトに名前を付けて保存] で任意のフォルダに保存します.今回は S
ampleDLL という名前で保存しています.保存したら,[Ctrl] + [F9] でコンパイルします.DLL が作成されます.
下図は,出力先ディレクトリを . に変更してコンパイルした結果です.デフォルトの出力先は [Win21] フォルダの階層下です.これは,EXE ができる場所と同じです.

これで DLL の作成は終了です.Delphi の IDE を閉じます.



図2
保存してコンパイルした結果
  • DLL が作成されている
  • SampleDLL.lpr がプロジェクトファイル

必要であれば,DLL のプロジェクトにユニットを追加できます.
新規にユニットを追加するには,[ファイル] [新規作成] [ユニット] で追加します.既存のユニットを裁可するには,[プロジェクト] [プロジェクトに追加] で追加します.





02_DLL を使用するプログラムを作成して実行


新規に VCL フォームアプリケーションを作成します.
フォームに TButton を 2 つ配置します.フォームのユニットのコードを,図の下のコードにします. このプロジェクトを,DLL のプロジェクトのファイルと同じフォルダ内に保存します.[F9] で実行します.下図はその結果です. 今回は,DLL を EXE と同じフォルダ内に置いてテストしています.

DLL の関数や手続きの宣言は,implementation 部に記述しても構いません.
external 指令は,この関数を外部から呼び込むことを意味しています.その後の文字列が,その関数が存在する DLL の名前です.



図3
[Button1] クリック
  • DLL 内の関数 AddValue を実行
図4
[Button2] クリック
  • DLL 内の関数 MulValue を実行

リスト2
unit Unit1;

interface

uses
  Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes,
  Vcl.Graphics, Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.ExtCtrls, Vcl.StdCtrls;

type
  TForm1 = class(TForm)
    Button1: TButton;
    Button2: TButton;
    procedure Button1Click(Sender: TObject);
    procedure Button2Click(Sender: TObject);
  private
    { Private 宣言 }
  public
    { Public 宣言 }
  end;

  function AddValue(AVal1, AVal2: Integer): Integer; stdcall; external 'SampleDLL.dll';
  function MulValue(AVal1, AVal2: Double): Double; stdcall; external 'SampleDLL.dll';

var
  Form1: TForm1;

implementation

{$R *.dfm}

procedure TForm1.Button1Click(Sender: TObject);
var
  LValue : Integer;
  LText  : string;
begin
  LValue := AddValue(3000, 500);

  LText := '計算結果' + sLineBreak + FormatFloat(',0', LValue);
  MessageBox(Handle, PChar(LText), '情報', MB_ICONINFORMATION);
end;

procedure TForm1.Button2Click(Sender: TObject);
var
  LValue : Double;
  LText  : string;
begin
  LValue := MulValue(3000, 500);

  LText := '計算結果' + sLineBreak + FormatFloat(',0.000', LValue);
  MessageBox(Handle, PChar(LText), '結果', MB_ICONINFORMATION);
end;

end.




03_DLL の置き場所


DLL は EXE が実行時に使用するファイルです.したがって,DLL は,システム的にパスが通った場所に存在している必要があります.EXE が最初に探しに行くのは EXE があるフォルダです.次に EXE が探しに行くのは,下表のシステムフォルダです.
64 ビット版の Windows の場合は,32 ビットの EXE は SysWOW64 内を探に行きます.64 ビットの EXE は System32 内を探しに行きます.32 ビット版の Windows の場合は,常に System32 内を探しに行きます.32 ビット版の Windows では,64 ビットの EXE は実行できません.

DLL を動的にロードして使用する場合は,任意のフォルダに置いて利用できます.



フォルダ 説明
%SystemRoot%\system32 64 ビット版の Windows 7 では 64 ビット用のシステムフォルダ
32 ビット版の Windows では 32 ビット用のシステムフォルダ
実フォルダ名は Windows\System32

64 ビット版の Windows では,このフォルダを指定しても,32 ビットのアプリは %SystemRoot%\SysWOW64 内のファイルを使用する (リダイレクト機能による)
%SystemRoot%\SysWOW64 64 ビット版の Windows では 32 ビット用のシステムフォルダ
32 ビット版の Windows にはない
実フォルダ名は Windows\SysWOW64

32 ビットのアプリは,%SystemRoot%\system32 を指定しても自動的にこちらにリダイレクトされる


一方,コンポーネントなどのユニットファイルは,コンパイルして EXE を作成する時に必要なファイルです.つまり,開発時,設計時に必要なファイルです.これらは,ライブラリパスが通った場所に必要です.ライブラリパスというのは,IDE が認識可能なフォルタということになります.IDE が最初に探しに行くのは,プロジェクトファイルがあるフォルダです.
一般敵に,当サイトの記事もそうですが,アプリ開発時の関係の記事では,ライブラリパスのことを,単にパスと言うことがあります.



[備考]
64 ビット版の Windows の 64 ビット用のシステムフォルダは System32 です.
64 ビット版の Windows の 32 ビット用のシステムフォルダは,SysWOW64 です,
末尾の 32, 64 は,実際のビットではありません.WOW64 は,[ Windows on Win64 ] ( 64 bit の Windows で 32 bit のウィンドウ ) の意味です.

Windows が 32 ビット版であるか,64 ビット版であるかは,以下のリンクをクリックするか,コマンドとして実行したダイアログの,[システムの種類] で確認できます,
      ms-settings:about