"Hello World" WIA ミニドライバー UI 拡張機能の作成
WIA ミニドライバー UI 拡張機能は、いくつかの関数をエクスポートし、以下の 4 つの COM インターフェイス識別子 (IID) の少なくとも 1 つを実装するシンプルな DLL です。
IID_IWiaUIExtensionIWiaUIExtension インターフェイスのインターフェイス識別子 (IID)。 これは、マイ コンピューターとコントロール パネルのミニドライバー デバイス アイコンを置き換え、マイクロソフトの一般的なミニドライバー UI ダイアログを置き換えるために使用される標準 WIA インターフェイスです。
IID_IShellExtInitIShellExtInit インターフェイスの IID です。 これは、プロパティ シート、ショートカット メニュー、ドラッグ アンド ドロップ ハンドラー (既定以外のドラッグ アンド ドロップ操作中にショートカット メニューに項目を追加する拡張機能) のシェル拡張機能を初期化するために使用される標準の Windows シェル インターフェイスです。
IID_IContextMenuContextMenu インターフェイスの IID です。 これは、シェル オブジェクト (マイ コンピューターと コントロール パネル の WIA ミニドライバー アイコン) に関連付けられたショートカット メニューを作成またはマージするために使用される標準の Windows シェル インターフェイスです。
IID_IShellPropSheetIShellPropSheet インターフェイスの IID です。 これは、シェル オブジェクト (マイ コンピューターと コントロール パネル の WIA ミニドライバー アイコン) に表示されるプロパティ シートのページを追加または置換するために使用される標準の Windows シェル インターフェイスです。
"Hello World" WIA ミニドライバー UI 拡張機能は、以下のファイルで構成されています。
hellowld.inf これはインストール ファイルです (元の hellowld サンプルでこの UI 拡張機能をインストールするように変更されています)。
hellowldui.def これは、DllGetClassObject と DllCanUnloadNow の 2 つの COM エクスポートを含む定義ファイルです (どちらも Windows SDK ドキュメントで説明されています)。
hellowldui.cpp WIA UI 拡張機能の実装です。
WIA UI 拡張機能のインストール
WIA UI 拡張機能 DLL をインストールするには、UI クラス ID={<UI 拡張機能の DLL の CLSID>} を DeviceData セクションの INF ファイルに追加します。 この CLSID を使用すると、クライアントは CoCreateInstance (Microsoft Windows SDK ドキュメントで説明) を呼び出し、WIA UI 拡張機能のサポートされているインターフェイスを取得できます。
次の INF スニペットの例は、「"Hello World" WIA ミニドライバーの作成」にある WIA ミニドライバー サンプルから派生しています。 既定で使用される CLSID は、一般的なダイアログ、アイコン、およびプロパティ ページ用のマイクロソフト提供の CLSID でなければなりません。
インストールを容易にするため、すべての WIA UI 拡張機能 DLL に COM オブジェクトを自己登録させることをお勧めします。 このサンプルには、自己登録 COM オブジェクトは含まれていません。
[WIADevice.DeviceData]
Server=local
UI DLL=sti.dll
UI Class ID={4DB1AD10-3391-11D2-9A33-00C04FA36145}
次の例は、UI クラス ID サブキーを hellowldui サンプル UI 拡張機能の CLSID に設定する完全な INF ファイルです。
; HELLOWLD.INF -- Hello World WIA Minidriver setup file (with a WIA UI extension DLL)
; Copyright (c) 2002 Hello World Company
; Manufacturer: Hello World Company
[Version]
Signature="$WINDOWS NT$"
Class=Image
ClassGUID={6bdd1fc6-810f-11d0-bec7-08002be2092f}
Provider=%Mfg%
DriverVer=06/26/2001,1.0.0.0
CatalogFile=wia.cat
PnpLockdown=1
[DestinationDirs]
DefaultDestDir=13
[Manufacturer]
%Mfg%=Models,NTx86
[Models.NTx86]
%WIADevice.DeviceDesc% = WIADevice.Scanner, HELLOWORLD_PNP_ID
[WIADevice.Scanner]
Include=sti.inf
Needs=STI.SerialSection
SubClass=StillImage
DeviceType=1
DeviceSubType=0x0
Capabilities=0x30
DeviceData=WIADevice.DeviceData
AddReg=WIADevice.AddReg
CopyFiles=WIADevice.CopyFiles
ICMProfiles="sRGB Color Space Profile.icm"
[WIADevice.Scanner.Services]
Include=sti.inf
Needs=STI.SerialSection.Services
[WIADevice.DeviceData]
Server=local
UI DLL=sti.dll
UI Class ID={7C1E2309-A535-45b1-94B3-9A020EE600C7}
[WIADevice.AddReg]
HKR,,HardwareConfig,1,1
HKR,,USDClass,,"{7C1E2309-A535-45b1-94B3-9A020EE600C6}"
HKCR,CLSID\{7C1E2309-A535-45b1-94B3-9A020EE600C6},,,"Hello World WIA Minidriver"
HKCR,CLSID\{7C1E2309-A535-45b1-94B3-9A020EE600C6}\InProcServer32,,,%13%\hellowld.dll
HKCR,CLSID\{7C1E2309-A535-45b1-94B3-9A020EE600C6}\InProcServer32,ThreadingModel,,Both
HKCR,CLSID\{7C1E2309-A535-45b1-94B3-9A020EE600C7},,,"Hello World WIA Minidriver UI Extension"
HKCR,CLSID\{7C1E2309-A535-45b1-94B3-9A020EE600C7}\InProcServer32,,,%13%\hellowldui.dll
HKCR,CLSID\{7C1E2309-A535-45b1-94B3-9A020EE600C7}\InProcServer32,ThreadingModel,,Both
HKCR,CLSID\{7C1E2309-A535-45b1-94B3-9A020EE600C7}\shellex\WiaDialogExtensionHandlers\{7C1E2309-A535-45b1-94B3-9A020EE600C7}
[WIADevice.CopyFiles]
hellowld.dll
hellowldui.dll
[SourceDisksFiles.x86]
hellowld.dll=1
hellowldui.dll=1
[SourceDisksNames.x86]
1=%Location%,,,
[Strings]
Mfg="Hello World Company"
WIADevice.DeviceDesc="Hello World WIA Minidriver"
Location="Hello World WIA Minidriver Installation Source"
hellowldui.def ファイルには、次のコードが含まれていなければなりません。
LIBRARY HELLOWLDUI
EXPORTS
DllGetClassObject PRIVATE
DllCanUnloadNow PRIVATE
hellowldui.cpp ファイルには、次のコードが含まれていなければなりません。
#ifndef WIN32_LEAN_AND_MEAN
#define WIN32_LEAN_AND_MEAN
#endif
#include <windows.h>
#include <initguid.h>
#include <wiadevd.h>
#include <shobjidl.h>
#include <shlobj.h>
// {7C1E2309-A535-45b1-94B3-9A020EE600C7}
DEFINE_GUID(CLSID_HelloWorldWIAUIExtension, 0x7c1e2309, 0xa535, 0x45b1, 0x94, 0xb3, 0x9a, 0x2, 0xe, 0xe6, 0x0, 0xc7);
class CWIAUIExtension : public IWiaUIExtension, // WIA UI Extension interface
public IShellExtInit, // SHELL Extension interface
public IContextMenu, // SHELL context menu Extension interface
public IShellPropSheetExt // SHELL property sheet interface
{
public:
/////////////////////////////////////////////////////////////////////////
// Construction/Destruction Section //
/////////////////////////////////////////////////////////////////////////
CWIAUIExtension() : m_cRef(1) {
}
~CWIAUIExtension() {
}
private:
LONG m_cRef; // object reference count.
public:
/////////////////////////////////////////////////////////////////////////
// Standard COM Section //
/////////////////////////////////////////////////////////////////////////
STDMETHODIMP QueryInterface(REFIID riid,LPVOID *ppvObj)
{
if (!ppvObj) {
return E_INVALIDARG;
}
*ppvObj = NULL;
if (IsEqualIID( riid, IID_IUnknown )) {
*ppvObj = reinterpret_cast<IUnknown*>(this);
} else if (IsEqualIID( riid, IID_IWiaUIExtension )) {
*ppvObj = static_cast<IWiaUIExtension*>(this);
} else {
return E_NOINTERFACE;
}
reinterpret_cast<IUnknown*>(*ppvObj)->AddRef();
return S_OK;
}
STDMETHODIMP_(ULONG) AddRef()
{
return InterlockedIncrement(&m_cRef);
}
STDMETHODIMP_(ULONG) Release()
{
if(InterlockedDecrement(&m_cRef) == 0) {
delete this;
return 0;
}
return m_cRef;
}
/////////////////////////////////////////////////////////////////////////
// IWiaUIExtension Interface Section //
/////////////////////////////////////////////////////////////////////////
STDMETHODIMP DeviceDialog( PDEVICEDIALOGDATA pDeviceDialogData ) {return E_NOTIMPL;}
STDMETHODIMP GetDeviceIcon( BSTR bstrDeviceId, HICON *phIcon, ULONG nSize ){
HRESULT hr = E_NOTIMPL;
HICON hIcon = reinterpret_cast<HICON>(LoadImage(NULL,
MAKEINTRESOURCE(IDI_APPLICATION),
IMAGE_ICON,
nSize,
nSize,
LR_SHARED));
if (hIcon) {
*phIcon = CopyIcon(hIcon);
hIcon = NULL;
hr = S_OK;
}
return hr;
}
STDMETHODIMP GetDeviceBitmapLogo( BSTR bstrDeviceId, HBITMAP *phBitmap, ULONG nMaxWidth, ULONG nMaxHeight ){return E_NOTIMPL;}
/////////////////////////////////////////////////////////////////////////
// IShellExtInit Interface Section //
/////////////////////////////////////////////////////////////////////////
STDMETHODIMP Initialize (LPCITEMIDLIST pidlFolder,LPDATAOBJECT lpdobj,HKEY hkeyProgID){return E_NOTIMPL;}
/////////////////////////////////////////////////////////////////////////
// IContextMenu Interface Section //
/////////////////////////////////////////////////////////////////////////
STDMETHODIMP QueryContextMenu (HMENU hmenu,UINT indexMenu,UINT idCmdFirst,UINT idCmdLast,UINT uFlags) {return E_NOTIMPL;}
STDMETHODIMP InvokeCommand (LPCMINVOKECOMMANDINFO lpici){return E_NOTIMPL;}
STDMETHODIMP GetCommandString (UINT_PTR idCmd, UINT uType,UINT* pwReserved,LPSTR pszName,UINT cchMax) {return E_NOTIMPL;}
/////////////////////////////////////////////////////////////////////////
// IShellPropSheetExt Interface Section //
/////////////////////////////////////////////////////////////////////////
STDMETHODIMP AddPages (LPFNADDPROPSHEETPAGE lpfnAddPage,LPARAM lParam){return E_NOTIMPL;}
STDMETHODIMP ReplacePage (UINT uPageID,LPFNADDPROPSHEETPAGE lpfnReplacePage,LPARAM lParam) {return E_NOTIMPL;}
};
/////////////////////////////////////////////////////////////////////////
// IClassFactory Interface Section (for all COM objects) //
/////////////////////////////////////////////////////////////////////////
class CWIAUIClassFactory : public IClassFactory {
public:
CWIAUIClassFactory() : m_cRef(1) {}
~CWIAUIClassFactory(){}
STDMETHODIMP QueryInterface(REFIID riid, LPVOID *ppv)
{
if (!ppv) {
return E_INVALIDARG;
}
*ppv = NULL;
HRESULT hr = E_NOINTERFACE;
if (IsEqualIID(riid, IID_IUnknown) || IsEqualIID(riid, IID_IClassFactory)) {
*ppv = static_cast<IClassFactory*>(this);
reinterpret_cast<IUnknown*>(*ppv)->AddRef();
hr = S_OK;
}
return hr;
}
STDMETHODIMP_(ULONG) AddRef()
{
return InterlockedIncrement(&m_cRef);
}
STDMETHODIMP_(ULONG) Release()
{
if(InterlockedDecrement(&m_cRef) == 0) {
delete this;
return 0;
}
return m_cRef;
}
STDMETHODIMP CreateInstance(IUnknown __RPC_FAR *pUnkOuter,REFIID riid,void __RPC_FAR *__RPC_FAR *ppvObject)
{
if ((pUnkOuter)&&(!IsEqualIID(riid,IID_IUnknown))) {
return CLASS_E_NOAGGREGATION;
}
HRESULT hr = E_NOINTERFACE;
CWIAUIExtension *pUIExt = new CWIAUIExtension();
if (pUIExt) {
hr = pUIExt->QueryInterface(riid,ppvObject);
pUIExt->Release();
} else {
hr = E_OUTOFMEMORY;
}
return hr;
}
STDMETHODIMP LockServer(BOOL fLock){return S_OK;}
private:
LONG m_cRef;
};
/////////////////////////////////////////////////////////////////////////
// DLL Entry Point Section (for all COM objects, in a DLL) //
/////////////////////////////////////////////////////////////////////////
extern "C" __declspec(dllexport) BOOL APIENTRY DllEntryPoint(HINSTANCE hinst,DWORD dwReason,LPVOID lpReserved)
{
switch (dwReason) {
case DLL_PROCESS_ATTACH:
break;
}
return TRUE;
}
extern "C" STDMETHODIMP DllCanUnloadNow(void){return S_OK;}
extern "C" STDAPI DllGetClassObject(REFCLSID rclsid,REFIID riid,LPVOID *ppv)
{
if (!ppv) {
return E_INVALIDARG;
}
HRESULT hr = CLASS_E_CLASSNOTAVAILABLE;
if (IsEqualCLSID(rclsid, CLSID_HelloWorldWIAUIExtension)) {
CWIAUIClassFactory *pcf = new CWIAUIClassFactory;
if (pcf) {
hr = pcf->QueryInterface(riid,ppv);
pcf->Release();
} else {
hr = E_OUTOFMEMORY;
}
}
return hr;
}
カスタム デバイス アイコンの追加
前のサンプルは、デバイスの既定のアイコンを置き換える方法の例です。 既定のアイコンを置き換える方法は、複数のデバイスがインストールされている場合に適切なデバイスを使用するようユーザーを誘導する理想的な方法です。 接続されているデバイスにアイコンが似ていれば、ユーザーにとってより直感的になります。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示