wiasGetChangedValueGuid, fonction (wiamdef.h)

Article
02/07/2025

La fonction wiasGetChangedValueGuid détermine si une propriété avec une valeur GUID a été modifiée par une application.

Syntaxe

HRESULT wiasGetChangedValueGuid(
  [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 est défini sur 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 de retour

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 en raison des modifications de propriété demandées par l’application.