Méthode IWiaItem ::EnumDeviceCapabilities (wia_xp.h)

Article
03/03/2024

La méthode IWiaItem ::EnumDeviceCapabilities crée un énumérateur qui est utilisé pour déterminer les commandes et les événements qu’un appareil d’acquisition d’images Windows (WIA) prend en charge.

Syntaxe

HRESULT EnumDeviceCapabilities(
  [in]  LONG              lFlags,
  [out] IEnumWIA_DEV_CAPS **ppIEnumWIA_DEV_CAPS
);

Paramètres

[in] lFlags

Type : LONG

Spécifie un indicateur qui sélectionne le type de fonctionnalités à énumérer. Peut être défini sur une ou plusieurs des valeurs suivantes :

Indicateur	Signification
WIA_DEVICE_COMMANDS	Énumérer les commandes d’appareil.
WIA_DEVICE_EVENTS	Énumérer les événements d’appareil.

[out] ppIEnumWIA_DEV_CAPS

Type : IEnumWIA_DEV_CAPS**

Pointeur vers IEnumWIA_DEV_CAPS interface créée par IWiaItem ::EnumDeviceCapabilities.

Valeur retournée

Type : HRESULT

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

Remarques

Utilisez cette méthode pour créer un objet énumérateur afin d’obtenir le jeu de commandes et d’événements pris en charge par un appareil WIA. Vous pouvez utiliser le paramètre lFlags pour spécifier les types de fonctionnalités d’appareil à énumérer. La méthode IWiaItem ::EnumDeviceCapabilities stocke l’adresse de l’interface de l’objet énumérateur dans le paramètre ppIEnumWIA_DEV_CAPS .

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wia_xp.h (incluez Wia.h)
Bibliothèque	Wiaguid.lib
DLL	Wiaservc.dll

Partager via