VC PlusPlus:LIB/DLLの生成とLIB呼び出し、DLL呼び出しについて

概要

　DLLやLIBを自作する基礎についての記事です。LIBファイルはDLLを作成すると同じフォルダに吐き出されます。なのでDLLを作成する記事になります。それから生成したLIBファイルとDLLを使う基礎についても記述します。

DLLを作成する

　そもそも、この記事はVisual Studio C++記事の子記事ですので、Visual Studioを使ったDLLの作成方法を示すものです。

１．Visual Studio 2022 CommunityでC++のプロジェクトを作成するためのツールを起動します。スタートアップダイアログで、プロジェクトの新規作成を選択します。

２．テンプレート一覧から、ダイナミックリンクライブラリを選択します。

３．ソリューション名を入力します。ここではCppDLLとします。プロジェクト名も同一とします。ソリューションファイルとプロジェクトファイルは同じディレクトリの配置します。作成するディレクトリは規定値(C:\User\(ユーザID)\source\repos\)を使います。

４．ソリューションエクスプローラーの[Header File]を右クリックして表示されるコンテクストメニューから[追加]-[新規の項目]を選択します。

５．ヘッダーファイルを追加するので、ファイル名欄に「CppDLL.h」と指定して[OK]ボタンを押します。

６．以下のようにプログラムを記述します。

int ifDllfunc(void) という関数を外部から使えるようにするためのヘッダファイルです。

#pragma once
#ifndef __CPPDLL_H
#define __CPPDLL_H

#ifdef CPPDLL_EXPORTS
#define CPPDLL_API __declspec(dllexport)
#else
#define CPPDLL_API __declspec(dllimport)
#endif
#ifdef __cplusplus
extern "C" {
#endif
	CPPDLL_API int ifDllfunc(void);
#ifdef __cplusplus
}
#endif
#endif

コードの説明

　CPPDLL_EXPORTS は、CppDLLプロジェクトを自動生成した時点で定義されているマクロです。DLLの生成側のプロジェクトであることを意味付けるためのマクロです。

　CPPDLL_EXPORTS が定義されている、本プロジェクトから、このヘッダファイルが参照されている場合には、DLLを出力するという意味のキーワードをつけた関数を定義する必要がありますので CPPDLL_API というマクロに __declspec(dllexport) を割り当てています。LIBファイルを読み込んで動作するような呼び出す側のホストアプリケーションでは *.lib ファイルと *.h を使って、このDLL生成プロジェクトに定義された関数を使う仕組みになっていて、その場合はDLLプロジェクトを入力として使うという意味のキーワードをつけた関数をヘッダファイルから定義する必要があり、 CPPDLL_API というマクロに __declspec(dllimport) を割り当てています。

　extern "C" { … } で関数を囲うことで、C言語の関数定義方法を使うことを宣言したことになります。名前修飾を行わないようにするために必須です。拡張子が *.cpp のファイルをC++としてコンパイルするときにはマクロ定義 __cplusplus がされているので、その場合だけ extern の定義をする形式にしています。CppのプロジェクトなのでライブラリがCでコンパイルされることを想定しなくても良さそうに思えますが、優しさですね。

　つまり、このような形式を使ってマクロ定義を切り替える仕組みはDLL作成において必須の記述になっていて無駄な記述ではありません。libファイルを使っての呼び出しにも対応する上ではプログラムをこれ以上に短くすることはできないです。最低限必要なことが詰め込まれています。