WIA_PROPERTY_CONTEXT-Struktur (wiamindr_lh.h)

Die WIA_PROPERTY_CONTEXT-Struktur speichert Eigenschaftsbezeichner und deren Kontext.

Syntax

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

Member

cProps

Gibt die Anzahl von Eigenschaftenbezeichnern an, die in dieser Struktur gespeichert sind.

pProps

Ist ein Array von Eigenschaftenbezeichnern, die die geschriebenen Eigenschaften angeben.

pChanged

Ein Array boolescher Werte, die angeben, welche Eigenschaften sich ändern. Ein Member dieses Arrays ist TRUE , wenn sich die entsprechende Eigenschaft ändert, und FALSE , wenn sich die entsprechende Eigenschaft nicht ändert. Das heißt, wenn pChanged[n] TRUE ist, wird pProps[n] geändert, und wenn pChanged[n] FALSE ist, wird pProps[n] nicht geändert.

Hinweise

Die booleschen Werte geben an, ob die entsprechende Eigenschaft von einer Anwendung geschrieben (geändert) wird, die IPropertyStorage::WriteMultiple aufruft.

Mehrere WIA-Dienstbibliotheksfunktionen verwenden die WIA_PROPERTY_CONTEXT-Struktur. Die Funktionen wiasCreatePropContext und wiasFreePropContext verwenden sie, wenn ein Eigenschaftenkontext erstellt oder freigegeben wird. WiasIsPropChanged und wiasSetPropChanged verwenden diese Struktur, um zu bestimmen, ob eine Eigenschaft geändert wurde, und um einen Eigenschaftskontext zu ändern, wenn sich die Eigenschaft ändert. Die Xxx-FunktionenwiasGetChangedValue verwenden diese Struktur, um zu bestimmen, ob sich eine Eigenschaft eines bestimmten Typs geändert hat. WiasUpdateValidFormat und wiasUpdateScanRect verwenden es, um einen Eigenschaftskontext bzw. die Größe des Scanbereichs für ein Scangerät zu aktualisieren.

Anforderungen

Anforderung Wert
Header wiamindr_lh.h (wiamindr.h einschließen)

Weitere Informationen

wiasCreatePropContext

wiasFreePropContext

wiasGetChangedValueFloat

wiasGetChangedValueGuid

wiasGetChangedValueLong

wiasGetChangedValueStr

wiasIsPropChanged

wiasSetPropChanged

wiasUpdateScanRect

wiasUpdateValidFormat