WIA_PROPERTY_CONTEXT structure (wiamindr_lh.h)
The WIA_PROPERTY_CONTEXT structure stores property identifiers and their context.
Syntax
typedef struct _WIA_PROPERTY_CONTEXT {
ULONG cProps;
PROPID *pProps;
BOOL *pChanged;
} WIA_PROPERTY_CONTEXT, *PWIA_PROPERTY_CONTEXT;
Members
cProps
Specifies the number of property identifiers stored in this structure.
pProps
Is an array of property identifiers that indicate the properties being written.
pChanged
Is an array of Boolean values indicating which properties are changing. A member of this array is TRUE if the corresponding property is changing, and FALSE if the corresponding property is not changing. That is, if pChanged[n] is TRUE, pProps[n] will be changed, and if pChanged[n] is FALSE, pProps[n] will not be changed.
Remarks
The Boolean values indicate whether the corresponding property is being written (changed) by an application calling IPropertyStorage::WriteMultiple.
Several WIA service library functions use the WIA_PROPERTY_CONTEXT structure. The wiasCreatePropContext and wiasFreePropContext functions use it when a property context is created or freed. The wiasIsPropChanged and wiasSetPropChanged use this structure to determine whether a property changed, and to modify a property context when the property does change. The wiasGetChangedValueXxx functions use this structure to determine whether a property of a certain type has changed. The wiasUpdateValidFormat and wiasUpdateScanRect use it to, respectively, update a property context and to update the scanning area sizes for a scanning device.
Requirements
| Requirement | Value |
|---|---|
| Header | wiamindr_lh.h (include Wiamindr.h) |