функция wiasCreatePropContext (wiamdef.h)

Статья
02/07/2025

Функция wiasCreatePropContext выделяет контекст свойства, чтобы указать, какие свойства элемента изменяются приложением.

Синтаксис

HRESULT wiasCreatePropContext(
                 ULONG                cPropSpec,
  [in]           PROPSPEC             *pPropSpec,
                 ULONG                cProps,
  [in, optional] PROPID               *pProps,
  [in]           WIA_PROPERTY_CONTEXT *pContext
);

Параметры

cPropSpec

Указывает общее количество структур PROPSPEC в массиве pPropSpec.

[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

См. также

WIA_PROPERTY_CONTEXT

wiasFreePropContext

wiasValidateItemProperties

Поделиться через