struttura WIA_PROPERTY_CONTEXT (wiamindr_lh.h)

Articolo
02/27/2024

La struttura WIA_PROPERTY_CONTEXT archivia gli identificatori di proprietà e il relativo contesto.

Sintassi

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

Members

cProps

Specifica il numero di identificatori di proprietà archiviati in questa struttura.

pProps

Matrice di identificatori di proprietà che indicano la scrittura delle proprietà.

pChanged

Matrice di valori booleani che indicano quali proprietà cambiano. Un membro di questa matrice è TRUE se la proprietà corrispondente viene modificata e FALSE se la proprietà corrispondente non viene modificata. Vale a dire, se pChanged[n] è TRUE, pProps[n] verrà modificato e se pChanged[n] è FALSE, pProps[n] non verrà modificato.

Commenti

I valori booleani indicano se la proprietà corrispondente viene scritta (modificata) da un'applicazione che chiama IPropertyStorage::WriteMultiple.

Diverse funzioni della libreria di servizi WIA usano la struttura WIA_PROPERTY_CONTEXT. Le funzioni wiasCreatePropContext e wiasFreePropContext lo usano quando viene creato o liberato un contesto di proprietà. WiasIsPropChanged e wiasSetPropChanged usano questa struttura per determinare se una proprietà è stata modificata e per modificare un contesto di proprietà quando la proprietà cambia. Le funzioni wiasGetChangedValueXxx usano questa struttura per determinare se una proprietà di un determinato tipo è stata modificata. Il wiasUpdateValidFormat e wiasUpdateScanRect lo usano rispettivamente per aggiornare un contesto di proprietà e aggiornare le dimensioni dell'area di analisi per un dispositivo di analisi.