IEnumWIA_DEV_CAPS ::Next, méthode (wia_xp.h)

Article
03/06/2024

La méthode IEnumWIA_DEV_CAPS ::Next remplit un tableau de pointeurs vers WIA_DEV_CAP structures.

Syntaxe

HRESULT Next(
  [in]      ULONG       celt,
  [out]     WIA_DEV_CAP *rgelt,
  [in, out] ULONG       *pceltFetched
);

Paramètres

[in] celt

Type : ULONG

Spécifie le nombre d’éléments de tableau dans le tableau indiqué par le paramètre rgelt .

[out] rgelt

Type : WIA_DEV_CAP*

Pointeur vers un tableau de structures WIA_DEV_CAP . IEnumWIA_DEV_CAPS ::Next remplit ce tableau de structures.

[in, out] pceltFetched

Type : ULONG*

En sortie, ce paramètre contient le nombre de pointeurs de structure réellement stockés dans le tableau indiqué par le paramètre rgelt .

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 cette méthode pour interroger les fonctionnalités de chaque appareil matériel d’acquisition d’images Windows (WIA) disponible. Pour ce faire, l’application passe un pointeur vers un tableau de structures WIA_DEV_CAP qu’elle alloue. Il transmet également le nombre d’éléments de tableau dans le celt de paramètre. La méthode IEnumWIA_DEV_CAPS ::Next remplit le tableau avec des structures. Les applications utilisent ensuite les structures pour énumérer les fonctionnalités des appareils matériels WIA.

Les fonctionnalités d’appareil WIA sont définies en tant qu’événements et commandes pris en charge par l’appareil. À l’aide du tableau rgelt , IEnumWIA_DEV_CAPS ::Next transmet une structure unique à l’application pour chaque événement et commande pris en charge par l’appareil.

Notez que IEnumWIA_DEV_CAPS ::Next alloue dynamiquement les structures WIA_DEV_CAP qu’il fournit aux applications. Par conséquent, les applications doivent supprimer les structures WIA_DEV_CAP qu’elles reçoivent via le paramètre rgelt . Les applications doivent utiliser SysFreeString pour libérer les champs bstrName, bstrDescription et bstrIcon de toutes les structures WIA_DEV_CAP .

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

Partager via