wiasCreatePropContext 函数 (wiamdef.h)
wiasCreatePropContext 函数分配属性上下文，以指示应用程序正在更改项的哪些属性。
语法
HRESULT wiasCreatePropContext(
ULONG cPropSpec,
[in] PROPSPEC *pPropSpec,
ULONG cProps,
[in, optional] PROPID *pProps,
[in] WIA_PROPERTY_CONTEXT *pContext
);
参数
cPropSpec
指定 pPropSpec 数组中的 PROPSPEC 结构的总数。
[in] pPropSpec
指向 PROPSPEC 结构数组的第一个元素的指针，标识哪些属性正在更改。
cProps
指定此上下文中存储的属性标识符数。
[in, optional] pProps
指向属性标识符数组的第一个元素的指针，该数组指示要放入此属性上下文中的属性。
[in] pContext
指向包含属性上下文 的WIA_PROPERTY_CONTEXT 结构的指针。
返回值
成功后，函数返回S_OK。 如果函数失败，它将返回标准 COM 错误或 WIA 错误代码之一。
注解
此函数分配属性上下文并填充其值。 此函数通常用于验证应用程序编写的属性的 wiasValidateItemProperties 。
属性上下文中的条目是具有依赖项或本身依赖于其他属性的属性的标识符。 上下文用于标记要更改的属性。 当不再需要属性上下文时，应通过调用 wiasFreePropContext 来释放它。
应用程序写入的属性由 pPropSpec 数组指定。 应用程序更改的属性以及依赖于更改的属性的任何属性都由 pProps 数组指定。 只能在 pProps 中指定已由应用程序 (更改的属性和) 的任何依赖属性。
有关详细信息， 请参阅 PROPSPEC 结构。
使用 wiasCreatePropContext 创建属性上下文时，驱动程序可以指定其他属性。
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
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wiamdef.h (包括 Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL | Wiaservc.dll |