estrutura WIA_PROPERTY_CONTEXT (wiamindr_lh.h)

Artigo
02/27/2024

A estrutura WIA_PROPERTY_CONTEXT armazena identificadores de propriedade e seu contexto.

Sintaxe

typedef struct _WIA_PROPERTY_CONTEXT {
  ULONG  cProps;
  PROPID *pProps;
  BOOL   *pChanged;
} WIA_PROPERTY_CONTEXT, *PWIA_PROPERTY_CONTEXT;

Membros

cProps

Especifica o número de identificadores de propriedade armazenados nessa estrutura.

pProps

É uma matriz de identificadores de propriedade que indicam as propriedades que estão sendo gravadas.

pChanged

É uma matriz de valores boolianos que indica quais propriedades estão sendo alteradas. Um membro dessa matriz será TRUE se a propriedade correspondente estiver sendo alterada e FALSE se a propriedade correspondente não estiver sendo alterada. Ou seja, se pChanged[n] for TRUE, pProps[n] será alterado e, se pChanged[n] for FALSE, pProps[n] não será alterado.

Comentários

Os valores boolianos indicam se a propriedade correspondente está sendo gravada (alterada) por um aplicativo que chama IPropertyStorage::WriteMultiple.

Várias funções da biblioteca de serviços WIA usam a estrutura WIA_PROPERTY_CONTEXT. As funções wiasCreatePropContext e wiasFreePropContext o usam quando um contexto de propriedade é criado ou liberado. Os wiasIsPropChanged e wiasSetPropChanged usam essa estrutura para determinar se uma propriedade foi alterada e modificar um contexto de propriedade quando a propriedade for alterada. As funções wiasGetChangedValueXxx usam essa estrutura para determinar se uma propriedade de um determinado tipo foi alterada. Os wiasUpdateValidFormat e wiasUpdateScanRect o usam para, respectivamente, atualizar um contexto de propriedade e atualizar os tamanhos de área de verificação de um dispositivo de verificação.