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

Статья
03/08/2023

Функция 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

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