wiasCreatePropContext, fonction (wiamdef.h)
La fonction wiasCreatePropContext alloue un contexte de propriété pour indiquer les propriétés d’un élément qui sont modifiées par l’application.
Syntaxe
HRESULT wiasCreatePropContext(
ULONG cPropSpec,
[in] PROPSPEC *pPropSpec,
ULONG cProps,
[in, optional] PROPID *pProps,
[in] WIA_PROPERTY_CONTEXT *pContext
);
Paramètres
cPropSpec
Spécifie le nombre total de structures PROPSPEC dans le tableau pPropSpec .
[in] pPropSpec
Pointeur vers le premier élément d’un tableau de structures PROPSPEC identifiant les propriétés qui changent.
cProps
Spécifie le nombre d’identificateurs de propriété stockés dans ce contexte.
[in, optional] pProps
Pointeur vers le premier élément d’un tableau d’identificateurs de propriété qui indiquent les propriétés à placer dans ce contexte de propriété.
[in] pContext
Pointeur vers une structure WIA_PROPERTY_CONTEXT qui contient un contexte de propriété.
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 alloue un contexte de propriété et remplit ses valeurs. Cette fonction est généralement utilisée dans wiasValidateItemProperties où les propriétés écrites par l’application sont validées.
Les entrées dans le contexte de propriété sont des identificateurs pour les propriétés qui ont des dépendances ou qui dépendent elles-mêmes d’autres propriétés. Un contexte est utilisé pour marquer les propriétés en cours de modification. Lorsque le contexte de propriété n’est plus nécessaire, il doit être libéré par un appel à wiasFreePropContext.
Les propriétés dans lesquelles une application écrit sont spécifiées par le tableau pPropSpec . Les propriétés qui ont été modifiées par l’application, ainsi que toutes les propriétés dépendantes des propriétés modifiées, sont spécifiées par le tableau pProps . Seules les propriétés qui ont été modifiées par l’application (et toutes les propriétés dépendantes) peuvent être spécifiées dans pProps.
Pour plus d’informations, consultez consultez la structure PROPSPEC .
Les pilotes peuvent spécifier des propriétés supplémentaires lors de la création d’un contexte de propriété avec wiasCreatePropContext.
Les propriétés suivantes sont toujours présentes dans WIA_PROPERTY_CONTEXT :
WIA_IPA_DATATYPE
WIA_IPA_DEPTH
WIA_IPS_XRES
WIA_IPS_XPOS
WIA_IPS_XEXTENT
WIA_IPA_PIXELS_PER_LINE
WIA_IPS_YRES
WIA_IPS_YPOS
WIA_IPS_YEXTENT
WIA_IPA_NUMBER_OF_LINES
WIA_IPS_CUR_INTENT
WIA_IPA_TYMED
WIA_IPA_FORMAT
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiamdef.h (incluez Wiamdef.h) |
| Bibliothèque | Wiaservc.lib |
| DLL | Wiaservc.dll |