wiasSetPropChanged-Funktion (wiamdef.h)
Die wiasSetPropChanged -Funktion ändert einen Eigenschaftenkontext, 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 geänderten Eigenschaft an.
[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 Member einer WIA_PROPERTY_CONTEXT-Struktur verwiesen wird. Weitere Informationen finden Sie im Abschnitt Anmerkungen.
Rückgabewert
Bei Erfolg gibt die Funktion S_OK zurück. Wenn die Funktion fehlschlägt, wird ein STANDARDMÄßIGer COM-Fehler oder einer der WIA_ERROR_XXX Fehler zurückgegeben (in der Microsoft Windows SDK-Dokumentation beschrieben).
Bemerkungen
Der pChanged Member der WIA_PROPERTY_CONTEXT-Struktur verweist 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 verwendet werden, wenn ein Treiber eine Eigenschaft ändert, die abhängige Eigenschaften in der Überprüfung aufweist. Wenn Sie z. B. "Aktuelle Absicht" ändern, wird die "Horizontale Auflösung" geändert und sollte als geändert markiert werden, sodass die Überprüfung von "X-Auflösung" (WIA_IPS_XRES) und deren Nachfolger weiterhin stattfindet.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows Me und in Windows XP und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | wiamdef.h (include Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL- | Wiaservc.dll |