struktur WIA_PROPERTY_CONTEXT (wiamindr_lh.h)

Artikel
08/08/2023

Struktur WIA_PROPERTY_CONTEXT menyimpan pengidentifikasi properti dan konteksnya.

Sintaks

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

Anggota

cProps

Menentukan jumlah pengidentifikasi properti yang disimpan dalam struktur ini.

pProps

Adalah array pengidentifikasi properti yang menunjukkan properti yang sedang ditulis.

pChanged

Adalah array nilai Boolean yang menunjukkan properti mana yang berubah. Anggota array ini TRUE jika properti terkait berubah, dan FALSE jika properti yang sesuai tidak berubah. Artinya, jika pChanged[n] adalah TRUE, pProps[n] akan diubah, dan jika pChanged[n] adalah FALSE, pProps[n] tidak akan diubah.

Keterangan

Nilai Boolean menunjukkan apakah properti yang sesuai sedang ditulis (diubah) oleh aplikasi yang memanggil IPropertyStorage::WriteMultiple.

Beberapa fungsi pustaka layanan WIA menggunakan struktur WIA_PROPERTY_CONTEXT. Fungsi wiasCreatePropContext dan wiasFreePropContext menggunakannya saat konteks properti dibuat atau dikosongkan. WiasIsPropChanged dan wiasSetPropChanged menggunakan struktur ini untuk menentukan apakah properti berubah, dan untuk memodifikasi konteks properti saat properti berubah. Fungsi wiasGetChangedValueXxx menggunakan struktur ini untuk menentukan apakah properti dari jenis tertentu telah berubah. WiasUpdateValidFormat dan wiasUpdateScanRect menggunakannya untuk, masing-masing, memperbarui konteks properti dan memperbarui ukuran area pemindaian untuk perangkat pemindaian.