estructura de WIA_PROPERTY_CONTEXT (wiamindr_lh.h)

La estructura WIA_PROPERTY_CONTEXT almacena los identificadores de propiedad y su contexto.

Sintaxis

typedef struct _WIA_PROPERTY_CONTEXT {
  ULONG  cProps;
  PROPID *pProps;
  BOOL   *pChanged;
} WIA_PROPERTY_CONTEXT, *PWIA_PROPERTY_CONTEXT;

Miembros

cProps

Especifica el número de identificadores de propiedad almacenados en esta estructura.

pProps

Es una matriz de identificadores de propiedad que indican las propiedades que se están escribiendo.

pChanged

Es una matriz de valores booleanos que indican qué propiedades cambian. Un miembro de esta matriz es TRUE si cambia la propiedad correspondiente y FALSE si la propiedad correspondiente no cambia. Es decir, si pChanged[n] es TRUE, se cambiará pProps[n] y si pChanged[n] es FALSE, no se cambiará pProps[n].

Comentarios

Los valores booleanos indican si una aplicación que llama a IPropertyStorage::WriteMultiple escribe la propiedad correspondiente (cambia).

Varias funciones de biblioteca de servicios WIA usan la estructura WIA_PROPERTY_CONTEXT. Las funciones wiasCreatePropContext y wiasFreePropContext la usan cuando se crea o libera un contexto de propiedad. WiasIsPropChanged y wiasSetPropChanged usan esta estructura para determinar si una propiedad ha cambiado y para modificar un contexto de propiedad cuando cambia la propiedad. Las funciones wiasGetChangedValueXxx usan esta estructura para determinar si ha cambiado una propiedad de un tipo determinado. WiasUpdateValidFormat y wiasUpdateScanRect lo usan para, respectivamente, actualizar un contexto de propiedad y actualizar los tamaños del área de examen para un dispositivo de examen.

Requisitos

Requisito Valor
Header wiamindr_lh.h (incluya Wiamindr.h)

Consulte también

wiasCreatePropContext

wiasFreePropContext

wiasGetChangedValueFloat

wiasGetChangedValueGuid

wiasGetChangedValueLong

wiasGetChangedValueStr

wiasIsPropChanged

wiasSetPropChanged

wiasUpdateScanRect

wiasUpdateValidFormat