Metode IWiaDevMgr2::RegisterEventCallbackProgram

Metode IWiaDevMgr2::RegisterEventCallbackProgram mendaftarkan aplikasi untuk menerima peristiwa perangkat. Ini terutama disediakan untuk kompatibilitas mundur dengan aplikasi yang tidak ditulis untuk Windows Image Acquisition (WIA) 2.0.

Sintaks

HRESULT RegisterEventCallbackProgram(
  [in]       LONG lFlags,
  [in]       BSTR bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in]       BSTR bstrFullAppName,
  [in]       BSTR bstrCommandlineArg,
  [in]       BSTR bstrName,
  [in]       BSTR bstrDescription,
  [in]       BSTR bstrIcon
);

Parameter

lFlags [in]

Jenis: LONG

Bendera pendaftaran. Dapat diatur ke nilai berikut.

Nilai	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

Pengidentifikasi perangkat. Teruskan NULL untuk mendaftar acara di semua perangkat WIA 2.0.

pEventGUID [in]

Jenis: const GUID*

Peristiwa yang didaftarkan aplikasi. Untuk daftar GUID peristiwa yang valid, lihat Pengidentifikasi Peristiwa WIA.

bstrFullAppName [in]

Jenis: BSTR

Nama jalur lengkap aplikasi.

bstrCommandlineArg [in]

Jenis: BSTR

Argumen baris perintah yang sesuai untuk aplikasi.

bstrName [in]

Jenis: BSTR

Nama aplikasi. Nama ditampilkan kepada pengguna ketika beberapa aplikasi mendaftar untuk peristiwa yang sama.

bstrDescription [in]

Jenis: BSTR

Deskripsi aplikasi. Deskripsi ditampilkan kepada pengguna ketika beberapa aplikasi mendaftar untuk peristiwa yang sama.

bstrIcon [in]

Jenis: BSTR

Ikon yang mewakili aplikasi. Ikon ditampilkan kepada pengguna ketika beberapa aplikasi mendaftar untuk peristiwa yang sama. String berisi nama aplikasi dan indeks berbasis nol ikon yang dipisahkan oleh koma, misalnya, "MyApp, 0". Mungkin ada lebih dari satu ikon yang mewakili aplikasi.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Gunakan IWiaDevMgr2::RegisterEventCallbackProgram untuk mendaftar peristiwa perangkat keras. Ketika terjadi peristiwa yang didaftarkan aplikasi, aplikasi diluncurkan, dan informasi peristiwa dikirimkan ke aplikasi.

Gunakan metode EnumRegisterEventInfo untuk mengambil pointer ke objek enumerator untuk properti pendaftaran peristiwa.

Hanya gunakan metode IWiaDevMgr2::RegisterEventCallbackProgram untuk kompatibilitas mundur dengan aplikasi yang tidak ditulis untuk arsitektur WIA 2.0. Gunakan antarmuka Model Objek Komponen (COM) yang disediakan oleh arsitektur WIA 2.0 untuk aplikasi baru. Secara khusus, panggil IWiaDevMgr2::RegisterEventCallbackInterface atau IWiaDevMgr2::RegisterEventCallbackCLSID untuk mendaftarkan aplikasi baru untuk peristiwa perangkat.

Biasanya, metode ini dipanggil oleh program penginstalan atau skrip. Program penginstalan atau skrip mendaftarkan aplikasi untuk menerima peristiwa perangkat WIA 2.0. Ketika peristiwa terjadi, aplikasi dimulai oleh sistem run-time WIA 2.0.

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