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

Weitere Informationen

WIA_PROPERTY_CONTEXT

wiasIsPropChanged