IEnumWiaItem2::Next, méthode

Remplit un tableau de pointeurs vers les interfaces IWiaItem2 .

Syntaxe

HRESULT Next(
  [in]      ULONG     cElt,
  [out]     IWiaItem2 **ppIWiaItem2,
  [in, out] ULONG     *pcEltFetched
);

Paramètres

cElt [in]

Type : ULONG

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

ppIWiaItem2 [out]

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*

À 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 . Une fois l’énumération terminée, ce paramètre contient zéro.

Valeur retournée

Type : HRESULT

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

Notes

Le système d’exécution d’acquisition d’images Windows (WIA) 2.0 représente les 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 du dossier actif de l’arborescence d’objets IWiaItem2 d’un appareil matériel.

Pour obtenir la liste des pointeurs, l’application transmet un tableau de pointeurs d’interface IWiaItem2 qu’elle alloue. Il transmet é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 les interfaces IWiaItem2 .

Tant que le processus d’énumération n’est pas terminé, la méthode IEnumWiaItem2::Next retourne S_OK. Chaque fois qu’il le fait, il définit la valeur pointée par pcEltFetched sur le nombre d’éléments qu’il a insérés dans le tableau. Lorsque IEnumWiaItem2::Next termine le processus d’énumération des objets IWiaItem2 , il retourne S_FALSE et définit l’emplacement de mémoire pointé par pcEltFetched sur 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 .

Spécifications