Metode IWiaDevMgr::RegisterEventCallbackCLSID (wia_xp.h)

  • Artikel

Metode IWiaDevMgr::RegisterEventCallbackCLSID mendaftarkan aplikasi untuk menerima peristiwa bahkan jika aplikasi mungkin tidak berjalan.

Sintaks

HRESULT RegisterEventCallbackCLSID(
  [in] LONG       lFlags,
  [in] BSTR       bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in] const GUID *pClsID,
  [in] BSTR       bstrName,
  [in] BSTR       bstrDescription,
  [in] BSTR       bstrIcon
);

Parameter

[in] lFlags

Jenis: LONG

Menentukan bendera pendaftaran. Dapat diatur ke nilai berikut:

Bendera Pendaftaran Makna
WIA_REGISTER_EVENT_CALLBACK Daftar untuk acara tersebut.
WIA_UNREGISTER_EVENT_CALLBACK Hapus pendaftaran untuk peristiwa tersebut.
WIA_SET_DEFAULT_HANDLER Atur aplikasi sebagai penanganan aktivitas default.

[in] bstrDeviceID

Jenis: BSTR

Menentukan pengidentifikasi perangkat. Teruskan NULL untuk mendaftar acara di semua perangkat WIA.

[in] pEventGUID

Jenis: const GUID*

Menentukan peristiwa tempat aplikasi mendaftar. Untuk daftar peristiwa standar, lihat Pengidentifikasi Peristiwa WIA.

[in] pClsID

Jenis: const GUID*

Arahkan ke ID kelas aplikasi (CLSID). Sistem run-time WIA menggunakan CLSID aplikasi untuk memulai aplikasi ketika terjadi peristiwa yang terdaftar.

[in] bstrName

Jenis: BSTR

Menentukan nama aplikasi yang mendaftar untuk peristiwa tersebut.

[in] bstrDescription

Jenis: BSTR

Menentukan deskripsi teks aplikasi yang mendaftar untuk peristiwa tersebut.

[in] bstrIcon

Jenis: BSTR

Menentukan nama file gambar yang akan digunakan untuk ikon untuk aplikasi yang mendaftar untuk peristiwa tersebut.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Aplikasi WIA menggunakan metode ini untuk mendaftar untuk menerima peristiwa perangkat keras jenis WIA_ACTION_EVENT. Setelah program memanggil IWiaDevMgr::RegisterEventCallbackCLSID, mereka terdaftar untuk menerima peristiwa perangkat WIA bahkan jika tidak berjalan.

Ketika peristiwa terjadi, sistem WIA menentukan aplikasi mana yang terdaftar untuk menerima peristiwa. Ini menggunakan fungsi CoCreateInstance dan ID kelas yang ditentukan dalam parameter pClsID untuk membuat instans aplikasi. Kemudian memanggil metode ImageEventCallback aplikasi untuk mengirimkan informasi peristiwa.

Aplikasi dapat memanggil metode EnumRegisterEventInfo untuk menghitung informasi pendaftaran peristiwa.

Aplikasi dapat menemukan apakah peristiwa adalah peristiwa jenis tindakan atau jenis pemberitahuan (atau keduanya) dengan memeriksa nilai ulFlags dari struktur WIA_DEV_CAP yang dikembalikan oleh enumerasi peristiwa.

Jika aplikasi bukan komponen Model Objek Komponen (COM) terdaftar dan tidak kompatibel dengan arsitektur WIA, pengembang harus menggunakan IWiaDevMgr::RegisterEventCallbackProgram alih-alih metode ini.

Catatan Dalam aplikasi multi-utas, tidak ada jaminan bahwa panggilan balik pemberitahuan peristiwa akan masuk pada utas yang sama yang mendaftarkan panggilan balik.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header wia_xp.h (termasuk Wia.h)
Pustaka Wiaguid.lib
DLL Wiaservc.dll