属性上下文

属性上下文为微型驱动程序提供了一种便捷的方式,用于在验证这些属性期间标识它感兴趣的多个属性。 使用属性上下文,微型驱动程序可以快速确定是否正在更改任何已标识的属性。 然后,微型驱动程序将属性上下文传递给 WIA 服务库函数之一, (例如 wiasGetChangedValueFloat) ,后者使用该上下文来确定应用程序是否正在更改属性值。

WIA 验证方法是,当应用程序更改属性时,还应更新任何依赖属性。 但是,如果应用程序也在更改依赖属性,则只需检查顶级属性来确定其新值是否有效。 与属性验证相关的 WIA 服务库函数使用此原则来决定何时更新依赖属性,以及何时应检查才有效。

一组属性的上下文在 WIA_PROPERTY_CONTEXT 结构中维护,该结构包含三个成员:属性上下文中的属性数、指向属性标识符数组的指针 (PROPID) ,以及指向 BOOL 值数组的指针。 数组以并行 (即,属性标识符在属性标识符数组中位于索引 N 的属性与 BOOL 数组) 中同一索引处的 BOOL 值相关联。

微型驱动程序调用 WIA 服务库函数 wiasCreatePropContext 来分配内存并填充属性上下文的值。 其他 WIA 服务库函数(如 wiasGetChangedValueFloat)使用属性上下文来确定何时应更新属性值。