wiasCreatePropContext-Funktion (wiamdef.h)
Die wiasCreatePropContext--Funktion weist einen Eigenschaftskontext 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 Gesamtanzahl der PROPSPEC-Strukturen im pPropSpec- Array an.
[in] pPropSpec
Zeigen Sie auf das erste Element eines Arrays von PROPSPEC-Strukturen, die bestimmen, welche Eigenschaften sich ändern.
cProps
Gibt die Anzahl der in diesem Kontext gespeicherten Eigenschaftenbezeichner an.
[in, optional] pProps
Zeigen Sie auf das erste Element eines Arrays von Eigenschaftsbezeichnern, die die Eigenschaften angeben, die in diesen Eigenschaftskontext eingefügt werden sollen.
[in] pContext
Zeigen Sie auf eine WIA_PROPERTY_CONTEXT Struktur, die einen Eigenschaftskontext enthält.
Rückgabewert
Bei Erfolg gibt die Funktion S_OK zurück. Wenn die Funktion fehlschlägt, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.
Bemerkungen
Diese Funktion weist einen Eigenschaftskontext zu und füllt seine Werte aus. Diese Funktion wird in der Regel in wiasValidateItemProperties verwendet, in dem die von der Anwendung geschriebenen Eigenschaften überprüft werden.
Einträge im Eigenschaftenkontext sind Bezeichner für Eigenschaften, die entweder abhängig sind oder 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 wiasFreePropContextfreigegeben werden.
Die Eigenschaften, in die eine Anwendung schreibt, werden durch das pPropSpec Array angegeben. Die Eigenschaften, die von der Anwendung geändert wurden, sowie alle Eigenschaften, die von den geänderten Eigenschaften abhängig sind, werden durch das pProps Array angegeben. In pProps-können nur Eigenschaften angegeben werden, die von der Anwendung (und von abhängigen Eigenschaften) geändert wurden.
Weitere Informationen. siehe die PROPSPEC- Struktur.
Treiber können beim Erstellen eines Eigenschaftenkontexts mit wiasCreatePropContext zusätzliche Eigenschaften angeben.
Die folgenden Eigenschaften sind immer in WIA_PROPERTY_CONTEXT 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 |
| Header- | wiamdef.h (include Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL- | Wiaservc.dll |