Método IWiaDevMgr::CreateDevice (wia_xp.h)

El IWiaDevMgr::CreateDevice crea un árbol jerárquico de objetos IWiaItem para un dispositivo windows Image Acquisition (WIA).

Sintaxis

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

Parámetros

[in] bstrDeviceID

Tipo: BSTR

Especifica el identificador único del dispositivo WIA.

[out] ppWiaItemRoot

Tipo: IWiaItem**

Puntero a un puntero a la interfaz IWiaItem del elemento raíz en el árbol jerárquico del dispositivo WIA.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las aplicaciones usan el método IWiaDevMgr::CreateDevice para crear un objeto de dispositivo para los dispositivos WIA especificados por el parámetro bstrDeviceID .

Cuando vuelve, el método IWiaDevMgr::CreateDevice almacena una dirección de un puntero en el parámetro ppWiaItemRoot. El puntero apunta al elemento raíz del árbol de objetos IWiaItem creados por IWiaDevMgr::CreateDevice. Las aplicaciones pueden usar este árbol de objetos para controlar y recuperar datos del dispositivo WIA.

Tenga en cuenta que las aplicaciones deben llamar al método IUnknown::Release en los punteros que reciben a través del parámetro ppWiaItemRoot .

Requisitos

Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wia_xp.h (incluye Wia.h)
Library	Wiaguid.lib
Archivo DLL	Wiaservc.dll