fonction wiasReadMultiple (wiamdef.h)

La fonction wiasReadMultiple récupère plusieurs valeurs de propriété à partir d’un élément WIA.

Syntaxe

HRESULT wiasReadMultiple(
  [in]            BYTE           *pWiasContext,
                  ULONG          ulCount,
  [in]            const PROPSPEC *ps,
  [out]           PROPVARIANT    *pv,
  [out, optional] PROPVARIANT    *pvOld
);

Paramètres

[in] pWiasContext

Pointeur vers un contexte d’élément WIA.

ulCount

Spécifie le nombre de propriétés à lire.

[in] ps

Pointeur vers le premier élément d’un tableau de structures PROPSPEC , contenant les propriétés à lire.

[out] pv

Pointeur vers le premier élément d’un tableau de structures PROPVARIANT . Au retour, ces structures contiennent de nouvelles valeurs pour les propriétés.

[out, optional] pvOld

Pointeur vers le premier élément d’un tableau de structures PROPVARIANT précédemment allouées par le minidriver. Lors du retour, le tableau contient les valeurs précédentes des données de propriété. Si ces informations ne sont pas nécessaires, ce paramètre peut être défini sur NULL.

Valeur retournée

En cas de réussite, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une erreur COM standard ou l’un des codes d’erreur WIA.

Remarques

Cette fonction lit plusieurs propriétés à partir d’un élément WIA. Lorsque l’appel réussit, le minidriver doit appeler PropVariantClear sur chaque élément du tableau spécifié par le paramètre pv . Pour plus d’informations, consultez IPropertyStorage ::ReadMultiple .

Configuration requise

Voir aussi

wiasWriteMultiple