WIA_PROPERTY_CONTEXT structure (wiamindr_lh.h)

La structure WIA_PROPERTY_CONTEXT stocke les identificateurs de propriété et leur contexte.

Syntaxe

typedef struct _WIA_PROPERTY_CONTEXT {
  ULONG  cProps;
  PROPID *pProps;
  BOOL   *pChanged;
} WIA_PROPERTY_CONTEXT, *PWIA_PROPERTY_CONTEXT;

Membres

cProps

Spécifie le nombre d’identificateurs de propriété stockés dans cette structure.

pProps

Tableau d’identificateurs de propriétés qui indiquent les propriétés en cours d’écriture.

pChanged

Tableau de valeurs booléennes indiquant les propriétés qui changent. Un membre de ce tableau est TRUE si la propriété correspondante change, et FALSE si la propriété correspondante ne change pas. Autrement dit, si pChanged[n] a la valeur TRUE, pProps[n] sera modifié et si pChanged[n] a la valeur FALSE, pProps[n] ne sera pas modifié.

Remarques

Les valeurs booléennes indiquent si la propriété correspondante est écrite (modifiée) par une application appelant IPropertyStorage ::WriteMultiple.

Plusieurs fonctions de bibliothèque de services WIA utilisent la structure WIA_PROPERTY_CONTEXT. Les fonctions wiasCreatePropContext et wiasFreePropContext l’utilisent lorsqu’un contexte de propriété est créé ou libéré. WiasIsPropChanged et wiasSetPropChanged utilisent cette structure pour déterminer si une propriété a changé et pour modifier un contexte de propriété lorsque la propriété change. Les fonctions wiasGetChangedValueXxx utilisent cette structure pour déterminer si une propriété d’un certain type a changé. WiasUpdateValidFormat et wiasUpdateScanRect l’utilisent pour, respectivement, mettre à jour un contexte de propriété et mettre à jour les tailles de zone d’analyse d’un appareil d’analyse.

Configuration requise

Condition requise Valeur
En-tête wiamindr_lh.h (incluez Wiamindr.h)

Voir aussi

wiasCreatePropContext

wiasFreePropContext

wiasGetChangedValueFloat

wiasGetChangedValueGuid

wiasGetChangedValueLong

wiasGetChangedValueStr

wiasIsPropChanged

wiasSetPropChanged

wiasUpdateScanRect

wiasUpdateValidFormat