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 |