WIA_PROPERTY_CONTEXT 結構 (wiamindr_lh.h)

發行項
03/01/2024

WIA_PROPERTY_CONTEXT 結構會儲存屬性識別碼及其內容。

語法

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

成員

cProps

指定儲存在此結構中的屬性識別碼數目。

pProps

這是屬性識別碼的陣列，表示正在寫入的屬性。

pChanged

這是布爾值的陣列，指出哪些屬性正在變更。如果對應的屬性正在變更，則此數位的成員為 TRUE ，如果對應的屬性未變更，則為 FALSE 。也就是說，如果 pChanged[n] 為 TRUE，pProps[n] 將會變更，如果 pChanged[n] 為 FALSE，pProps[n] 將不會變更。

備註

布爾值指出對應的屬性是否正在由呼叫 IPropertyStorage：：WriteMultiple 的應用程式 (變更) 。

數個 WIA 服務連結庫函式會使用 WIA_PROPERTY_CONTEXT 結構。 wiasCreatePropContext 和wiasFreePropContext函式會在建立或釋放屬性內容時使用它。 wiasIsPropChanged 和wiasSetPropChanged會使用此結構來判斷屬性是否已變更，以及在屬性變更時修改屬性內容。 wiasGetChangedValueXxx 函式會使用此結構來判斷特定類型的屬性是否已變更。 wiasUpdateValidFormat 和wiasUpdateScanRect分別用來更新屬性內容，以及更新掃描裝置的掃描區域大小。