Función wiasIsPropChanged (wiamdef.h)

2025-02-07

La función wiasIsPropChanged comprueba si una aplicación ha cambiado una propiedad especificada.

Sintaxis

HRESULT wiasIsPropChanged(
        PROPID               propid,
  [in]  WIA_PROPERTY_CONTEXT *pContext,
  [out] BOOL                 *pbChanged
);

Parámetros

propid

Especifica el identificador de propiedad de la propiedad que se va a comprobar.

[in] pContext

Puntero a una estructura WIA_PROPERTY_CONTEXT que contiene el contexto de propiedad actual.

[out] pbChanged

Puntero a una ubicación de memoria que recibe un valor BOOL. El valor BOOL se TRUE si la propiedad ha cambiado y FALSE si la propiedad no ha cambiado.

Valor devuelto

Si la función se ejecuta correctamente, devuelve S_OK.

Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error WIA.

Observaciones

Esta función determina si se cambia una propiedad examinando el valor de miembro bChanged en la estructura WIA_PROPERTY_CONTEXT de la propiedad. Los minidrivers suelen usar esta función para comprobar cuándo se ha cambiado una propiedad independiente para que se puedan actualizar sus dependientes.