DLLScreenCap サンプル : MFC と静的または動的にリンクする標準 DLL の例

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

DLLScreenCap サンプルでは、画面キャプチャツールのダイナミックリンクライブラリ (DLL: Dynamic Link Library) バージョンについて説明します。DLLScreenCap は、以前の DLLTRACE サンプルに取って代わるものです。DLLTRACE は、MFC Version 1.0 で導入され、MFC ライブラリと静的にリンクされた DLL を作成する方法を示していました。DLLScreenCap は、動的にリンクされる Microsoft Windows ベースのアプリケーションに対する C ベースのプログラムインターフェイスを備えています。MFC ライブラリと静的にリンクされた DLL は、MFC クラスから派生した一切のクラスのメンバ関数を正常にエクスポートできません。

DLL を MFC ライブラリに静的にリンクする方法については、「テクニカルノート 11: DLL の構成要素としての MFC」を参照してください。DLLScreenCap サンプルを拡張 DLL にせずに MFC と動的にリンクすることもできます。MFC と静的にリンクしてカスタム DLL を実装する前に、「テクニカルノート 33: MFC の DLL バージョン」および DLLHUSK サンプルの説明を参照して、MFC 拡張 DLL として実装することも検討してください。

MFC ライブラリにリンクされた非拡張 DLL には、実行可能な MFC アプリケーションの場合と同様に、CWinApp 派生クラスおよびそのアプリケーションクラスの単一オブジェクトが必要です。アプリケーションの CWinApp オブジェクトはメインメッセージポンプを備えていますが、DLL の CWinApp オブジェクトにはこの機能がありません。DLL でモードレスダイアログボックスを開く場合、または DLL 固有のメインフレームウィンドウがある場合は、DLL がエクスポートしたルーチンをアプリケーションのメインメッセージポンプで呼び出す必要があります。このルーチンが、DLL のアプリケーションオブジェクトの CWinApp::PreTranslateMessage メンバ関数を呼び出します。詳細については、DLLScreenCap.dll がエクスポートする FilterDllMsg 関数を参照してください。

ScreenCapApi.h では、クライアントアプリケーションとの DLL インターフェイスを備えるために、extern "C" で関数を定義する方法を示しています。extern "C" を使用すると、次のような利点があります。第 1 に、DLL を C++ 以外のクライアントアプリケーションで使用できます。第 2 に、エクスポートされた名前に C++ の名前の装飾が適用されないため、DLL のオーバーヘッドが減少します。第 3 に、C++ の名前の装飾を意識せずに、序数によるエクスポートのための .def ファイルに明示的に追加することがより簡単になります。

セキュリティに関するメモ :
このサンプルコードは概念を示す目的で提供されているものです。必ずしも最も安全なコーディング手法に従っているわけではないため、アプリケーションまたは Web サイトでは使用しないでください。Microsoft は、サンプルコードが意図しない目的で使用された場合に、付随的または間接的な損害について責任を負いません。

このサンプルコードは概念を示す目的で提供されているものです。必ずしも最も安全なコーディング手法に従っているわけではないため、アプリケーションまたは Web サイトでは使用しないでください。Microsoft は、サンプルコードが意図しない目的で使用された場合に、付随的または間接的な損害について責任を負いません。

サンプルとそのインストール手順を取得するには

Visual Studio で、[ヘルプ] メニューの [サンプル] をクリックします。

詳細については、「サンプルファイルの格納場所」を参照してください。
使用できるサンプルの最新バージョンと完全な一覧については、オンラインの Visual Studio 2008 Samples のページを参照してください。
サンプルは、コンピュータのハードディスク上にもあります。既定では、サンプルおよび Readme ファイルは、\Program Files\Visual Studio 9.0\Samples\ の下のフォルダにコピーされます。Visual Studio Express Edition の場合、すべてのサンプルはオンライン上にあります。

サンプルのビルドと実行

DLLScreenCap サンプルは、2 つのプロジェクトで構成されています。DLL プロジェクトの DLLScreenCap と、DLL を呼び出す EXE プロジェクトの ScreenCap です。

提供されたソリューションから ScreenCap をビルドすると、自動的に DLLScreenCap がビルドされ、ScreenCap の出力ディレクトリに DLL がコピーされます。

メモこのサンプルではカスタムビルドステップを使用してファイルをコピーするため、UNC パスを使用してソリューションを開かないでください。ドライブ名の付いたディレクトリにサンプルファイルを置いてください。

DLLScreenCap サンプルをビルドおよび実行するには

DllScreenCap.sln ソリューションファイルを開きます。
ソリューションエクスプローラで、[ScreenCap] プロジェクトフォルダを右クリックし、ショートカットメニューの [スタートアッププロジェクトとして設定] をクリックします。
[ビルド] メニューの [ビルド] をクリックします。
[デバッグ] メニューの [デバッグなしで開始] をクリックします。

キャプチャした最後の画面が、ウィンドウのサイズに合わせて拡大/縮小され、ScreenCap のウィンドウに表示されます。[File] メニューの [Configure Screen Capture] をクリックします。キャプチャしたファイルを保存するパスや、画面またはアクティブウィンドウのどちらをキャプチャするかを指定するためのダイアログボックスが表示されます。[Screen Capture] をクリックしてキャプチャしたファイルを作成し、クライアントウィンドウの表示を更新します。

DLLScreenCap を変換して MFC DLL に動的にリンクする方法

DLLScreenCap は、モーダルダイアログボックスを表示するために呼び出されるエクスポートされた関数を持つ、標準 DLL の作成方法を示します。以前のバージョンの Visual C++ では、この方法が標準 DLL での唯一の選択肢でした。このような DLL は、以前は _USRDLL と呼ばれていました。

現在では、標準 DLL は共有 MFCx0 DLL の MFC を使用できます。ビルドのサイズを縮小できる可能性があるため、共有 MFC DLL を使用して DLLScreenCap サンプルをビルドすることもできます。DLLScreenCap.dll で共有ライブラリを使用した場合は、DLL の 100 KB を超えるリリースビルドのサイズは約 16 KB に削減され、1 MB を超えるデバッグビルドのサイズは 100 KB に削減されます。DLLScreenCap で動的なリンクをサポートするには、AFX_MANAGE_STATE マクロを使用してグローバル MFC モジュール状態を正しく切り替えてください。

DLLScreenCap を共有ライブラリで使用できることを確認するには

ソリューションエクスプローラで、[ScreenCap] プロジェクトノードを右クリックし、ショートカットメニューの [プロパティ] をクリックします。

[プロパティページ] ダイアログボックスが表示されます。
[構成] ボックスの [複数の構成] をクリックします。[プロパティページ] ダイアログボックスの詳細については、「Visual C++ プロジェクトのプロパティの設定」を参照してください。
[Release] と [Debug] の両方のビルドを選択し、設定を変更します。
プロジェクトの全般プロパティページで、共有 DLL プロパティで MFC を使用するための MFC の使用プロパティが有効になっていることを確認します。
DLL からエクスポートされたすべての関数の先頭に、次のコード行があることを確認します。詳細については、「MFC モジュールの状態データの管理」を参照してください。
```
AFX_MANAGE_STATE(AfxGetStaticModuleState())
```

たとえば、DllScreenCap.dll は次の 4 つの関数をエクスポートします。

CaptureScreen
ConfigureCapture
ProcessDLLIdle
FilterDLLMsg

変換後の FilterDLLMsg は、次のようになります。

BOOL WINAPI FilterDllMsg(LPMSG lpMsg)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState())
   TRY
   {
       return AfxGetApp()->PreTranslateMessage(lpMsg);
   }
   END_TRY
return FALSE;
}

キーワード

このサンプルでは、次のキーワードを使用します。

CDialog::DoModal, CWinApp::InitInstance, CWinApp::OnIdle, CWinApp::PreTranslateMessage, CWnd::DoDataExchange, CWnd::GetClientRect, CWnd::OnPaint, ShowWindow, UpdateWindow, CImage, AFX_MANAGE_STATE, AfxGetStaticModuleState, CWnd::GetDesktopWindow, CWnd::GetActiveWindow, CImage::Create, CImageDC, CImage::Save, SHBrowseForFolder, CImage::Load, CDC::SetStretchBltMode, CImage::StretchBlt, CWnd::OnEraseBkgnd, CWindowDC

参照

その他の技術情報

MFC サンプル

次の方法で共有