fungsi wiasCreatePropContext (wiamdef.h)

  • Artikel

Fungsi wiasCreatePropContext mengalokasikan konteks properti untuk menunjukkan properti item mana yang sedang diubah oleh aplikasi.

Sintaks

HRESULT wiasCreatePropContext(
                 ULONG                cPropSpec,
  [in]           PROPSPEC             *pPropSpec,
                 ULONG                cProps,
  [in, optional] PROPID               *pProps,
  [in]           WIA_PROPERTY_CONTEXT *pContext
);

Parameter

cPropSpec

Menentukan jumlah total struktur PROPSPEC dalam array pPropSpec .

[in] pPropSpec

Penunjuk ke elemen pertama dari array struktur PROPSPEC yang mengidentifikasi properti mana yang berubah.

cProps

Menentukan jumlah pengidentifikasi properti yang disimpan dalam konteks ini.

[in, optional] pProps

Penunjuk ke elemen pertama dari array pengidentifikasi properti yang menunjukkan properti yang akan dimasukkan ke dalam konteks properti ini.

[in] pContext

Penunjuk ke struktur WIA_PROPERTY_CONTEXT yang berisi konteks properti.

Nilai kembali

Setelah berhasil, fungsi mengembalikan S_OK. Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kode kesalahan WIA.

Keterangan

Fungsi ini mengalokasikan konteks properti dan mengisi nilainya. Fungsi ini umumnya digunakan dalam wiasValidateItemProperties di mana properti yang ditulis oleh aplikasi divalidasi.

Entri dalam konteks properti adalah pengidentifikasi untuk properti yang memiliki dependen, atau tergantung pada properti lain. Konteks digunakan untuk menandai properti mana yang sedang diubah. Ketika konteks properti tidak lagi diperlukan, itu harus dibebaskan oleh panggilan ke wiasFreePropContext.

Properti tempat aplikasi menulis ditentukan oleh array pPropSpec . Properti yang diubah oleh aplikasi, serta properti apa pun tergantung pada properti yang diubah, ditentukan oleh array pProps . Hanya properti yang telah diubah oleh aplikasi (dan properti dependen apa pun) yang dapat ditentukan dalam pProps.

Untuk informasi selengkapnya. lihat struktur PROPSPEC .

Driver dapat menentukan properti tambahan saat membuat konteks properti dengan wiasCreatePropContext.

Properti berikut ini selalu ada di WIA_PROPERTY_CONTEXT:

  • WIA_IPA_DATATYPE

  • WIA_IPA_DEPTH

  • WIA_IPS_XRES

  • WIA_IPS_XPOS

  • WIA_IPS_XEXTENT

  • WIA_IPA_PIXELS_PER_LINE

  • WIA_IPS_YRES

  • WIA_IPS_YPOS

  • WIA_IPS_YEXTENT

  • WIA_IPA_NUMBER_OF_LINES

  • WIA_IPS_CUR_INTENT

  • WIA_IPA_TYMED

  • WIA_IPA_FORMAT

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header wiamdef.h (termasuk Wiamdef.h)
Pustaka Wiaservc.lib
DLL Wiaservc.dll

Lihat juga

WIA_PROPERTY_CONTEXT

wiasFreePropContext

wiasValidateItemProperties