IWiaDevMgr::CreateDevice 方法 (wia_xp.h)

IWiaDevMgr::CreateDevice 为 Windows 映像采集 (WIA) 设备创建 IWiaItem 对象的分层树。

语法

HRESULT CreateDevice(
  [in]  BSTR     bstrDeviceID,
  [out] IWiaItem **ppWiaItemRoot
);

参数

[in] bstrDeviceID

类型: BSTR

指定 WIA 设备的唯一标识符。

[out] ppWiaItemRoot

类型: IWiaItem**

指向指向 WIA 设备分层树中根项 的 IWiaItem 接口的指针的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

应用程序使用 IWiaDevMgr::CreateDevice 方法为 bstrDeviceID 参数指定的 WIA 设备创建设备对象。

返回时, IWiaDevMgr::CreateDevice 方法将指针的地址存储在参数 ppWiaItemRoot 中。 指针指向由 IWiaDevMgr::CreateDevice 创建的 IWiaItem 对象的树的根项。 应用程序可以使用此对象树来控制和检索 WIA 设备中的数据。

请注意,应用程序必须对通过 ppWiaItemRoot 参数收到的指针调用 IUnknown::Release 方法。

要求

   
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 wia_xp.h (包括 Wia.h)
Library Wiaguid.lib
DLL Wiaservc.dll