fonction wiasGetChangedValueStr (wiamdef.h)

Article
03/01/2024

La fonction wiasGetChangedValueStr détermine si une propriété avec une valeur de chaîne a été modifiée par une application.

Syntaxe

HRESULT wiasGetChangedValueStr(
  [in] BYTE                    *pWiasContext,
  [in] WIA_PROPERTY_CONTEXT    *pContext,
       BOOL                    bNoValidation,
       PROPID                  propID,
       WIAS_CHANGED_VALUE_INFO *pInfo
);

Paramètres

[in] pWiasContext

Pointeur vers un contexte d’élément WIA.

[in] pContext

Pointeur vers une structure WIA_PROPERTY_CONTEXT qui contient le contexte de propriété actuel.

bNoValidation

Indique si la valeur actuelle de la propriété doit être validée par rapport à son ensemble de valeurs valides. Si ce paramètre a la valeur TRUE, la fonction n’effectue pas de validation sur la propriété . Si elle est FALSE, la fonction effectue la validation des données.

propID

Spécifie l’identificateur de propriété de la propriété en cours de test.

pInfo

Pointeur vers une structure WIAS_CHANGED_VALUE_INFO qui contient les valeurs actuelles et précédentes de la propriété.

Valeur retournée

En cas de réussite, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une erreur COM standard ou l’un des codes d’erreur WIA.

Remarques

Le pilote doit valider la propriété uniquement une fois que le pilote a mis à jour les valeurs de la propriété. Le pilote met à jour les valeurs à la suite des modifications de propriété demandées par l’application.