wiasSetPropChanged-Funktion (wiamdef.h)
Die wiasSetPropChanged-Funktion ändert einen Eigenschaftskontext, um anzugeben, dass eine Eigenschaft geändert wird.
Syntax
HRESULT wiasSetPropChanged(
PROPID propid,
[in] WIA_PROPERTY_CONTEXT *pContext,
BOOL bChanged
);
Parameter
propid
Gibt den Eigenschaftenbezeichner der Eigenschaft an, die geändert wird.
[in] pContext
Zeiger auf eine WIA_PROPERTY_CONTEXT-Struktur , die den aktuellen Eigenschaftenkontext enthält.
bChanged
Gibt den BOOL-Wert an, der verwendet wird, um ein bestimmtes Element im Array festzulegen, auf das vom pChanged-Element einer WIA_PROPERTY_CONTEXT-Struktur verwiesen wird. Weitere Informationen finden Sie im Abschnitt Hinweise .
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_ERROR_XXX -Fehler zurück (beschrieben in der Microsoft Windows SDK-Dokumentation).
Hinweise
Das pChanged-Element der WIA_PROPERTY_CONTEXT-Struktur zeigt auf ein Array von BOOL-Werten, die angeben, ob eine bestimmte Eigenschaft geändert wird. Diese Funktion legt ein Element in diesem Array für die angegebene Eigenschaft im Eigenschaftenkontext fest. Diese Funktion sollte immer dann verwendet werden, wenn ein Treiber eine Eigenschaft ändert, die bei der Überprüfung abhängige Eigenschaften aufweist. Wenn Sie z. B. "Aktuelle Absicht" ändern, wird die "Horizontale Auflösung" geändert und sollte als geändert markiert werden, sodass die Validierung von "X-Auflösung" (WIA_IPS_XRES) und ihrer Abhängigen weiterhin erfolgt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows Me und in Windows XP und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | wiamdef.h (wiamdef.h einschließen) |
| Bibliothek | Wiaservc.lib |
| DLL | Wiaservc.dll |