IWiaDevMgr::CreateDevice, méthode (wia_xp.h)

IWiaDevMgr::CreateDevice crée une arborescence hiérarchique d’objets IWiaItem pour un appareil d’acquisition d’images Windows (WIA).

Syntaxe

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

Paramètres

[in] bstrDeviceID

Type : BSTR

Spécifie l’identificateur unique de l’appareil WIA.

[out] ppWiaItemRoot

Type : IWiaItem**

Pointeur vers un pointeur vers l’interface IWiaItem de l’élément racine dans l’arborescence hiérarchique de l’appareil WIA.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les applications utilisent la méthode IWiaDevMgr::CreateDevice pour créer un objet d’appareil pour les appareils WIA spécifiés par le paramètre bstrDeviceID .

Lorsqu’elle est retournée, la méthode IWiaDevMgr::CreateDevice stocke l’adresse d’un pointeur dans le paramètre ppWiaItemRoot. Le pointeur pointe vers l’élément racine de l’arborescence des objets IWiaItem créés par IWiaDevMgr::CreateDevice. Les applications peuvent utiliser cette arborescence d’objets pour contrôler et récupérer des données à partir de l’appareil WIA.

Notez que les applications doivent appeler la méthode IUnknown::Release sur les pointeurs qu’elles reçoivent via le paramètre ppWiaItemRoot .

Configuration requise