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
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamdef.h (einschließlich Wiamdef.h) |
| Bibliothek | Wiaservc.lib |
| DLL | Wiaservc.dll |