应用程序如何创建 WIA 设备
当应用程序打算使用 WIA 设备驱动程序时，它会调用 Microsoft Windows SDK 文档) 中所述的 IWiaDevMgr：：CreateDevice 方法 (。 WIA 服务首先调用 IStiUSD：：LockDevice 来锁定 WIA 驱动程序，以便进行互斥访问。 接下来，WIA 服务调用 IWiaMiniDrv：:d rvInitializeWia 来创建初始 WIA 项树结构。 最后，WIA 服务通过调用 IStiUSD：：UnLockDevice 解锁设备驱动程序。
IWiaMiniDrv：:d rvInitializeWia 方法应执行以下任务。
缓存 pStiDevice 参数指向的接口，以便正确锁定设备。 (有关详细信息，请参阅 IWiaMiniDrv：:d rvLockWiaDevice.)
创建初始 WIA 项树结构。
递增当前应用程序连接计数。 此计数用于通知驱动程序应用程序是否仍处于连接状态。 它还有助于确定在 IWiaMiniDrv：:d rvUnInitializeWia 中采取的适当操作。
WIA 项的名称应具有某种逻辑含义。 Microsoft 要求 Windows XP 及更高版本具有以下项名称。
平板
此术语表示仅支持平板扫描仪的扫描仪，或支持带文档送纸器的平板扫描仪的扫描仪。
WIA 服务调用 IWiaMiniDrv：:d rvInitializeWia 方法，以响应 WIA 应用程序对 IWiaDevMgr：：CreateDevice (windows SDK 文档) 中所述的调用。 其后果是 WIA 服务为每个新客户端连接调用 IWiaMiniDrv：:d rvInitializeWia 方法。
IWiaMiniDrv：:d rvInitializeWia 方法应初始化任何专用结构并创建驱动程序项树。 驱动程序项树显示此 WIA 设备支持的所有 WIA 项的布局。 此方法仅用于创建初始树结构， 而不 用于) WIA 属性 (内容。 WIA 服务将通过多次调用 IWiaMiniDrv：:d rvInitItemProperties 方法，单独填充 WIA 驱动程序项的 WIA 属性。
所有 WIA 设备都有一个根项，它是所有 WIA 设备项的父项。 若要创建 WIA 设备项，WIA 驱动程序应调用 WIA 服务帮助程序函数 wiasCreateDrvItem。
以下示例演示如何创建 WIA 设备根项。
LONG lItemFlags = WiaItemTypeFolder|WiaItemTypeDevice|WiaItemTypeRoot;
IWiaDrvItem *pIWiaDrvRootItem = NULL;
HRESULT hr =
wiasCreateDrvItem(
lItemFlags, // item flags
bstrRootItemName, // item name ("Root")
bstrRootFullItemName, // item full name ("0000\Root")
(IWiaMiniDrv *)this, // this WIA driver object
sizeof(MINIDRIVERITEMCONTEXT), // size of context
NULL, // context
&pIWiaDrvRootItem // created ROOT item
); // (IWiaDrvItem interface)
if(S_OK == hr){
//
// ROOT item was created successfully
//
}
若要创建位于上一示例中创建的根项正下方的 WIA 子项，请使用类似于下面的代码。
注意 ****请注意，调用 IWiaDrvItem：：AddItemToFolder 方法将新创建的子项添加到根项。
LONG lItemFlags = WiaItemTypeFile|WiaItemTypeDevice|WiaItemTypeImage;
PMINIDRIVERITEMCONTEXT pItemContext = NULL;
IWiaDrvItem *pIWiaDrvNewItem = NULL;
HRESULT hr =
wiasCreateDrvItem(
lItemFlags, // item flags
bstrItemName, // item name ("Flatbed")
bstrFullItemName, // item full name ("0000\Root\Flatbed")
(IWiaMiniDrv *)this, // this WIA driver object
sizeof(MINIDRIVERITEMCONTEXT), // size of context
(PBYTE)&pItemContext, // context
&pIWiaDrvNewItem // created child item
); // (IWiaDrvItem interface)
if(S_OK == hr){
//
// A New WIA driver item was created successfully
//
hr = pIWiaDrvNewItem->AddItemToFolder(pIWiaDrvRootItem); // add the new item to the ROOT
if(S_OK == hr){
//
// successfully created and added a new WIA driver item to
// the WIA driver item tree.
//
}
pNewItem->Release();
pNewItem = NULL;
}
以下示例演示 IWiaMiniDrv：:d rvInitializeWia 方法的 实现。
HRESULT _stdcall CWIADevice::drvInitializeWia(
BYTE *pWiasContext,
LONG lFlags,
BSTR bstrDeviceID,
BSTR bstrRootFullItemName,
IUnknown *pStiDevice,
IUnknown *pIUnknownOuter,
IWiaDrvItem **ppIDrvItemRoot,
IUnknown **ppIUnknownInner,
LONG *plDevErrVal)
{
//
// If the caller did not pass in the correct parameters,
// then fail the call with E_INVALIDARG.
//
if (!pWiasContext) {
return E_INVALIDARG;
}
if (!plDevErrVal) {
return E_INVALIDARG;
}
HRESULT hr = S_OK;
*plDevErrVal = 0;
*ppIDrvItemRoot = NULL;
*ppIUnknownInner = NULL;
if (m_pStiDevice == NULL) {
//
// save STI device interface for locking
//
m_pStiDevice = (IStiDevice *)pStiDevice;
}
//
// build WIA item tree
//
LONG lItemFlags = WiaItemTypeFolder|WiaItemTypeDevice|WiaItemTypeRoot;
IWiaDrvItem *pIWiaDrvRootItem = NULL;
//
// create the ROOT item of the WIA device. This name should NOT be
// localized in different languages. "Root" is used by WIA drivers.
//
BSTR bstrRootItemName = SysAllocString(WIA_DEVICE_ROOT_NAME);
if(!bstrRootItemName) {
return E_OUTOFMEMORY;
}
hr = wiasCreateDrvItem(lItemFlags, // item flags
bstrRootItemName, // item name ("Root")
bstrRootFullItemName, // item full name ("0000\Root")
(IWiaMiniDrv *)this, // this WIA driver object
sizeof(MINIDRIVERITEMCONTEXT), // size of context
NULL, // context
&pIWiaDrvRootItem); // created ROOT item
// (IWiaDrvItem interface)
if (S_OK == hr) {
//
// ROOT item was created successfully, save the newly created Root
// item in the pointer given by the WIA service (ppIDrvItemRoot).
//
*ppIDrvItemRoot = pIWiaDrvRootItem;
//
// Create a child item directly under the Root WIA item
//
lItemFlags = WiaItemTypeFile|WiaItemTypeDevice|WiaItemTypeImage;
PMINIDRIVERITEMCONTEXT pItemContext = NULL;
IWiaDrvItem *pIWiaDrvNewItem = NULL;
//
// create a name for the WIA child item. "Flatbed" is used by
// WIA drivers that support a flatbed scanner.
//
BSTR bstrItemName = SysAllocString(WIA_DEVICE_FLATBED_NAME);
if (bstrItemName) {
WCHAR wszFullItemName[MAX_PATH + 1] = {0};
_snwprintf(wszFullItemName,(sizeof(wszFullItemName) / sizeof(WCHAR)) - 1,L"%ls\\%ls",
bstrRootFullItemName,bstrItemName);
BSTR bstrFullItemName = SysAllocString(wszFullItemName);
if (bstrFullItemName) {
hr = wiasCreateDrvItem(lItemFlags, // item flags
bstrItemName, // item name ("Flatbed")
trFullItemName, // item full name ("0000\Root\Flatbed")
(IWiaMiniDrv *)this, // this WIA driver object
sizeof(MINIDRIVERITEMCONTEXT), // size of context
(BYTE**)&pItemContext, // context
&pIWiaDrvNewItem); // created child item
// (IWiaDrvItem interface)
if (S_OK == hr) {
//
// A New WIA driver item was created successfully
//
hr = pIWiaDrvNewItem->AddItemToFolder(pIWiaDrvRootItem); // add the new item to the ROOT
if (S_OK == hr) {
//
// successfully created and added a new WIA
// driver item to the WIA driver item tree.
//
}
//
// The new item is no longer needed, because it has
// been passed to the WIA service.
//
pIWiaDrvNewItem->Release();
pIWiaDrvNewItem = NULL;
}
SysFreeString(bstrFullItemName);
bstrFullItemName = NULL;
} else {
hr = E_OUTOFMEMORY;
}
SysFreeString(bstrItemName);
bstrItemName = NULL;
} else {
hr = E_OUTOFMEMORY;
}
}
//
// increment application connection count
//
if(S_OK == hr){
InterlockedIncrement(&m_lClientsConnected);
}
return hr;
}