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

Article
03/13/2024

La méthode IEnumWIA_DEV_INFO ::Next remplit un tableau de pointeurs vers les interfaces IWiaPropertyStorage .

Syntaxe

HRESULT Next(
  [in]      ULONG               celt,
  [out]     IWiaPropertyStorage **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 : IWiaPropertyStorage**

Reçoit l’adresse d’un tableau de pointeurs d’interface IWiaPropertyStorage . IEnumWIA_DEV_INFO ::Next remplit ce tableau avec des pointeurs d’interface.

[in, out] pceltFetched

Type : ULONG*

Lors de la sortie, ce paramètre contient le nombre de pointeurs d’interface réellement stockés dans le tableau indiqué par le paramètre rgelt .

Valeur retournée

Type : HRESULT

Bien qu’il reste des appareils à énumérer, cette méthode retourne S_OK. Elle retourne S_FALSE lorsque l’énumération est terminée. Si la méthode échoue, elle retourne un code d’erreur COM standard.

Remarques

Les applications utilisent cette méthode pour interroger les propriétés de chaque appareil matériel d’acquisition d’images Windows (WIA) disponible. Pour ce faire, l’application transmet un tableau de pointeurs d’interface IWiaPropertyStorage qu’elle alloue. Il transmet également le nombre d’éléments de tableau dans le celt de paramètre. La méthode IEnumWIA_DEV_INFO ::Next remplit le tableau avec des pointeurs vers les interfaces IWiaPropertyStorage . Les applications peuvent interroger les interfaces pour connaître les propriétés prises en charge par l’appareil.

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

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