キャプチャソフト開発 その３ DLLを作ってみる

DLLってそもそも何？なんか難しそう...
と思ったが、全然そんなことはなかった。

主に参考にしたサイト

• Link an executable to a DLL
• EternalWindows　Windows開発 / DLL
• EternalWindows　DLL / 関数のエクスポート

これらを参考に実装していきます。
本ページの目的を以下に示します。

• DLLを明示的に呼び出す
• DLLからHello Worldする

メインソースファイル

#include <stdio.h>

#include <windows.h>

#include "./util.h"



int main(int argc, char* argv[]) {

  (void)argc;

  (void)argv;



  // Load DLL.

  HINSTANCE hDLL = LoadLibrary(L"util.dll");

  if (hDLL == NULL) {

    fwprintf(stderr, L"Failed to load DLL\n");

    return 1;

  }



  // Load DLL function.

  void (*func)() = NULL;

  func = (void (*)())GetProcAddress(hDLL, "HelloWorld");

  if (func == NULL) {

    fwprintf(stderr, L"Failed to get function\n");

  } else {

    func();

  }



  // Release DLL.

  FreeLibrary(hDLL);



  return 0;

}

• hDLL
  今回作成したDLLへのインスタンスハンドルです。
• LoadLibrary、FreeLibrary
  それぞれ、DLLのロードと解放を行う関数です。
• GetProcAddress
  DLLから関数のアドレスを取得します。

DLLのソースファイル

#define DLLAPI extern "C" __declspec(dllexport)



#include "./util.h"

#include <stdio.h>



DLLAPI void HelloWorld() { wprintf(L"Hello World!\n"); }

DLLのヘッダファイル

#ifndef _UTIL_H_

#define _UTIL_H_



#include <stdio.h>



#ifndef DLLAPI

#define DLLAPI extern "C" __declspec(dllimport)

#endif



DLLAPI void HelloWorld();



#endif  // _UTIL_H_

• #define DLLAPI extern "C" __declspec(dllexport)
  DLLAPIマクロを、DLLのソースファイルではこのように定義しておきます。
  ヘッダファイルをインクルードする前に定義するのがポイントです。
• #define DLLAPI extern "C" __declspec(dllimport)
  DLLAPIマクロを、DLLのヘッダファイルではこのように定義しておきます。
• HelloWorld
  DLLに実装する、ハローワールドする関数です。
• DLLMainは？
  今回のケースは簡単なので、書かなくても大丈夫です。
  作りたいプログラムによっては、あると便利な場合もあるのでしょう。

DLLAPIマクロのからくりについては、参考サイトの方で詳しく解説されています。

メイクファイル

TARGET = main.exe

PDB = main.pdb

MAP = main.map

RES =

SRC = main.cc util.cc

OBJ = $(OBJDIR)\main.obj

DLL = util.dll

OBJDIR = build



CC = "$(VCINSTALLDIR)\cl.exe"

LINK = "$(VCINSTALLDIR)\link.exe"

CPPFLAGS = /nologo /W4 /Zi /O2 /MT /EHsc /Fd"$(TMPDIR)/" /DUNICODE /D_UNICODE \

      /DDEBUG

LFLAGS = "kernel32.lib" "user32.lib" "gdi32.lib" "winspool.lib" \

     "comdlg32.lib" "advapi32.lib" "shell32.lib" "ole32.lib" \

     "oleaut32.lib" "uuid.lib" "odbc32.lib" "odbccp32.lib" "libcmt.lib" \

     /NOLOGO /SUBSYSTEM:CONSOLE /DEBUG



ALL: $(TARGET)



$(TARGET): $(OBJ) $(DLL) $(RES)

 $(LINK) $(LFLAGS) /OUT:$(TARGET) /PDB:"$(PDB)" /MAP:"$(MAP)" \

 $(OBJ) $(RES)



.cc{$(OBJDIR)}.obj:

 @[ -d $(OBJDIR) ] || mkdir $(OBJDIR)

 $(CC) $(CPPFLAGS) /Fo"$(OBJDIR)\\" /c $<



.cc.dll:

 $(CC) $(CPPFLAGS) /LD $<



clean:

 rm $(OBJ) $(TARGET) *.map *.pdb *.ilk *.obj *.lib *.dll *.exp

• SUBSYSTEM:CONSOLE
  コンソールアプリケーションとしてビルドすることを、リンカオプションで設定します。
• .cc.dll
  CCファイルからDLLファイルを作るルールを指定します。
  clコンパイラでは、LDオプションを付けることでDLLを作れます。

DLLを含むプロジェクトのためのMakefileは初出ですが、.cc.dllのルールが加わったこと以外、あまり変わりませんね。

備考

意外とあっさりしていて驚いた。

DLLを扱ったことで、Windowsに対する理解が深まった気がする。

プロジェクト一式については、GitHubにも上げておきます。