Bagikan melalui

Metode IWiaDevMgr2::RegisterEventCallbackCLSID

  • Artikel

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

Sintaks

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

Parameter

lFlags [in]

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.

 

bstrDeviceID [in]

Jenis: BSTR

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

pEventGUID [in]

Jenis: const GUID*

Menentukan peristiwa yang didaftarkan aplikasi. Untuk daftar peristiwa standar, lihat Pengidentifikasi Peristiwa WIA.

pClsID [in]

Jenis: const GUID*

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

bstrName [in]

Jenis: BSTR

Menentukan nama aplikasi yang mendaftar untuk peristiwa tersebut.

bstrDescription [in]

Jenis: BSTR

Menentukan deskripsi teks aplikasi yang mendaftar untuk peristiwa tersebut.

bstrIcon [in]

Jenis: BSTR

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

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Aplikasi WIA 2.0 menggunakan metode ini untuk mendaftar untuk menerima peristiwa perangkat keras. Setelah IWiaDevMgr2::RegisterEventCallbackCLSID dipanggil, aplikasi terdaftar untuk menerima peristiwa perangkat WIA 2.0 meskipun tidak berjalan.

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

Aplikasi dapat memanggil metode EnumRegisterEventInfo untuk menghitung informasi pendaftaran peristiwa.

Jika aplikasi bukan komponen Model Objek Komponen (COM) terdaftar dan tidak kompatibel dengan arsitektur WIA 2.0, gunakan metode IWiaDevMgr2::RegisterEventCallbackProgram untuk mendaftarkan aplikasi untuk peristiwa perangkat.

Catatan

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

 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2008 [hanya aplikasi desktop]
Header
Wia.h