Méthode IWiaDevMgr2::CreateDevice

Article
06/13/2023

Crée une arborescence hiérarchique d’objets IWiaItem2 pour un appareil d’acquisition d’images Windows (WIA) 2.0.

Syntaxe

HRESULT CreateDevice(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrDeviceID,
  [out] IWiaItem2 **ppWiaItem2Root
);

Paramètres

lFlags [in]

Type : LONG

Actuellement inutilisé. Doit être défini sur zéro (0).

bstrDeviceID [in]

Type : BSTR

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

ppWiaItem2Root [out]

Type : IWiaItem2**

Reçoit l’adresse d’un pointeur vers l’interface IWiaItem2 de l’élément racine dans l’arborescence hiérarchique de l’appareil WIA 2.0.

Valeur retournée

Type : HRESULT

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

Notes

Les applications utilisent la méthode IWiaDevMgr2::CreateDevice pour créer un objet d’appareil pour les appareils WIA 2.0 spécifiés par le paramètre bstrDeviceID. Lorsqu’elle retourne, la méthode IWiaDevMgr2::CreateDevice stocke l’adresse d’un pointeur dans le paramètre ppWiaItem2Root, qui pointe vers l’élément racine de l’arborescence des objets IWiaItem2créés par IWiaDevMgr2::CreateDevice. Les applications peuvent utiliser cette arborescence d’objets pour contrôler et récupérer des données à partir de l’appareil WIA 2.0.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Wia.h
IDL	Wia.idl

Partager via