IEnumWiaItem2 :: Next, méthode
Remplit un tableau de pointeurs vers des interfaces IWiaItem2 .
Syntaxe
HRESULT Next(
[in] ULONG cElt,
[out] IWiaItem2 **ppIWiaItem2,
[in, out] ULONG *pcEltFetched
);
Paramètres
-
cElt [ dans]
-
Type : ULong
Spécifie le nombre d’éléments de tableau dans le tableau indiqué par le paramètre ppIWiaItem2 .
-
ppIWiaItem2 [ à]
-
Type : IWiaItem2**
Reçoit l’adresse d’un tableau de pointeurs d’interface IWiaItem2 . IEnumWiaItem2 :: Next remplit ce tableau avec des pointeurs d’interface.
-
pcEltFetched [ in, out]
-
Type : ULong *
Lors de la sortie, ce paramètre reçoit le nombre de pointeurs d’interface réellement stockés dans le tableau indiqué par le paramètre ppIWiaItem2 . Lorsque l’énumération est terminée, ce paramètre contient la valeur zéro.
Valeur retournée
Type : HRESULT
Si cette méthode est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .
Remarques
le système d’exécution d’acquisition d’images Windows (WIA) 2,0 représente des périphériques matériels wia 2,0 sous la forme d’une arborescence hiérarchique d’objets IWiaItem2 . Les applications utilisent la méthode IEnumWiaItem2 :: Next pour obtenir un pointeur d’interface IWiaItem2 pour chaque élément dans le dossier actif de l’arborescence d’objets IWiaItem2 d’un périphérique matériel.
Pour obtenir la liste des pointeurs, l’application passe un tableau de pointeurs d’interface IWiaItem2 qu’il alloue. Il passe également le nombre d’éléments de tableau dans le paramètre cElt. La méthode IEnumWiaItem2 :: Next remplit le tableau avec des pointeurs vers des interfaces IWiaItem2 .
Tant que le processus d’énumération n’est pas terminé, la méthode IEnumWiaItem2 :: Next retourne S _ OK. À chaque fois, il définit la valeur désignée par pcEltFetched sur le nombre d’éléments qu’il a insérés dans le tableau. Si IEnumWiaItem2 :: Next termine le processus d’énumération des objets IWiaItem2 , il retourne S _ false et définit l’emplacement de la mémoire désigné par pcEltFetched à zéro.
Les applications doivent appeler la méthode IUnknown :: Release sur les pointeurs d’interface qu’elles reçoivent via le paramètre ppIWiaItem2 .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 [ applications de bureau uniquement] |
| En-tête |
|
| MIDL |
|