wiasSetItemPropAttribs, fonction (wiamdef.h)
La fonction wiasSetItemPropAttribs définit les indicateurs d’accès et les valeurs valides pour l’ensemble de propriétés d’un élément.
Syntaxe
HRESULT wiasSetItemPropAttribs(
[in] BYTE *pWiasContext,
LONG cPropSpec,
[in] PROPSPEC *pPropSpec,
[in] PWIA_PROPERTY_INFO pwpi
);
Paramètres
[in] pWiasContext
Pointeur vers un contexte d’élément WIA.
cPropSpec
Spécifie le nombre de propriétés.
[in] pPropSpec
Pointeur vers le premier élément d’un tableau de structures PROPSPEC (défini dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows) indiquant les propriétés pour lesquelles définir des valeurs valides et des indicateurs d’accès.
[in] pwpi
Pointeur vers le premier élément d’un tableau de structures WIA_PROPERTY_INFO qui contiennent les valeurs de propriété à écrire.
Valeur de retour
En cas de réussite, la fonction retourne S_OK. Si la fonction échoue, elle retourne une erreur COM standard ou l’une des erreurs WIA_ERROR_XXX (décrites dans la documentation du Kit de développement logiciel (SDK) Windows).
Remarques
Les minidrivers doivent utiliser cette fonction pour initialiser des groupes de propriétés simples. Les groupes de propriétés peuvent être des bitsets, des plages de valeurs ou des listes de valeurs. Les types simples pris en charge, regroupés par attribut, sont les suivants.
| Attributs | Types pris en charge |
|---|---|
| WIA_PROP_FLAG | VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, VT_I8 |
| WIA_PROP_RANGE | VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, ,VT_I8, VT_R4, VT_R8 |
| WIA_PROP_LIST | VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, ,VT_I8, VT_R4, VT_R8, VT_BSTR |
Les minidrivers doivent initialiser des propriétés complexes à l’aide de la fonction wiasSetPropertyAttributes.
Le minidriver peut définir l’indicateur WIA_PROP_CACHEABLE sur une propriété qui ne change pas au fil du temps. En définissant cet indicateur sur une propriété, le minidriver indique que le service WIA peut mettre en cache la valeur de la propriété. Consultez la documentation du Kit de développement logiciel (SDK) Windows pour obtenir la liste de tous les attributs de propriété.
Il est important de se rappeler que wiasSetItemPropAttribs retourne un HRESULT, et non un BOOLEAN. Par exemple, si wiasSetItemPropAttribs retourne 0, cette valeur doit être interprétée comme S_OK plutôt que FALSE, et indique que tout a fonctionné comme prévu. Si wiasSetItemPropAttribs retourne le S_FALSE HRESULT, cela indique qu’une des propriétés que vous essayez de définir n’existe probablement pas dans le flux de propriétés.
Pour obtenir un journal wiadebug de cette erreur, ouvrez le Registre et activez la journalisation WIA pour les avertissements et les erreurs. La clé de Registre est la suivante : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\StillImage\Debug\wiaservc.dll
Définissez la valeur de « DebugFlags » sur 0x00000003
Redémarrez le système et répétez les étapes nécessaires pour générer cette erreur. Il y aura maintenant un fichier nommé « wiadebug.log » dans %windir% répertoire.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamdef.h (include Wiamdef.h) |
| bibliothèque | Wiaservc.lib |
| DLL | Wiaservc.dll |