wiasCreatePropContext-Funktion (wiamdef.h)

Die wiasCreatePropContext-Funktion weist einen Eigenschaftenkontext zu, um anzugeben, welche Eigenschaften eines Elements von der Anwendung geändert werden.

Syntax

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

Parameter

cPropSpec

Gibt die Gesamtzahl der PROPSPEC-Strukturen im pPropSpec-Array an.

[in] pPropSpec

Zeiger auf das erste Element eines Arrays von PROPSPEC-Strukturen, die identifizieren, welche Eigenschaften sich ändern.

cProps

Gibt die Anzahl der in diesem Kontext gespeicherten Eigenschaftenbezeichner an.

[in, optional] pProps

Zeiger auf das erste Element eines Arrays von Eigenschaftsbezeichnern, die die Eigenschaften angeben, die in diesen Eigenschaftenkontext eingefügt werden sollen.

[in] pContext

Zeiger auf eine WIA_PROPERTY_CONTEXT-Struktur , die einen Eigenschaftenkontext enthält.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück. Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.

Hinweise

Diese Funktion weist einen Eigenschaftskontext zu und füllt die zugehörigen Werte aus. Diese Funktion wird in der Regel in wiasValidateItemProperties verwendet, wo die von der Anwendung geschriebenen Eigenschaften überprüft werden.

Einträge im Eigenschaftenkontext sind Bezeichner für Eigenschaften, die entweder abhängig sind oder selbst von anderen Eigenschaften abhängig sind. Ein Kontext wird verwendet, um zu markieren, welche Eigenschaften geändert werden. Wenn der Eigenschaftenkontext nicht mehr benötigt wird, sollte er durch einen Aufruf von wiasFreePropContext freigegeben werden.

Die Eigenschaften, in die eine Anwendung schreibt, werden vom pPropSpec-Array angegeben. Die eigenschaften, die von der Anwendung geändert wurden, sowie alle von den geänderten Eigenschaften abhängigen Eigenschaften werden vom pProps-Array angegeben. In pProps können nur Eigenschaften angegeben werden, die von der Anwendung geändert wurden (und alle abhängigen Eigenschaften).

Weitere Informationen. sehen Sie sich die PROPSPEC-Struktur an.

Treiber können zusätzliche Eigenschaften angeben, wenn sie einen Eigenschaftenkontext mit wiasCreatePropContext erstellen.

Die folgenden Eigenschaften sind in WIA_PROPERTY_CONTEXT immer vorhanden:

• 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

Anforderungen

Weitere Informationen

WIA_PROPERTY_CONTEXT

wiasFreePropContext

wiasValidateItemProperties