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） |
| 库 | Wiaservc.lib |
| DLL | Wiaservc.dll |