WIA_PROPERTY_CONTEXT 结构 (wiamindr_lh.h)

项目
03/05/2024

WIA_PROPERTY_CONTEXT 结构存储属性标识符及其上下文。

语法

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

成员

cProps

指定存储在此结构中的属性标识符数。

pProps

指示正在写入的属性的属性标识符的数组。

pChanged

指示哪些属性正在更改的布尔值的数组。如果相应属性发生更改，则此数组的成员为 TRUE ;如果相应属性未更改，则为 FALSE 。也就是说，如果 pChanged[n] 为 TRUE，则 pProps[n] 将更改，如果 pChanged[n] 为 FALSE，则 pProps[n] 将不会更改。

注解

布尔值指示调用 IPropertyStorage：：WriteMultiple 的应用程序是否) 写入 (更改相应的属性。

多个 WIA 服务库函数使用 WIA_PROPERTY_CONTEXT 结构。 wiasCreatePropContext 和 wiasFreePropContext 函数在创建或释放属性上下文时使用它。 wiasIsPropChanged 和 wiasSetPropChanged 使用此结构来确定属性是否更改，并在属性发生更改时修改属性上下文。 wiasGetChangedValueXxx 函数使用此结构来确定某个类型的属性是否已更改。 wiasUpdateValidFormat 和 wiasUpdateScanRect 分别使用它来更新属性上下文和更新扫描设备的扫描区域大小。