Metode IWiaDevMgr2::RegisterEventCallbackInterface

Mendaftarkan aplikasi yang sedang berjalan untuk pemberitahuan peristiwa Windows Image Acquisition (WIA) 2.0.

Sintaks

HRESULT RegisterEventCallbackInterface(
  [in]        LONG              lFlags,
  [in]        BSTR              bstrDeviceID,
  [in]  const GUID              *pEventGUID,
  [in]        IWiaEventCallback *pIWiaEventCallback,
  [out]       IUnknown          **pEventObject
);

Parameter

lFlags [in]

Jenis: LONG

Saat ini tidak digunakan. Harus diatur ke nol.

bstrDeviceID [in]

Jenis: BSTR

Menentukan pengidentifikasi unik perangkat WIA 2.0. Atur parameter ini ke NULL untuk mendaftar peristiwa di semua perangkat WIA 2.0.

pEventGUID [in]

Jenis: const GUID*

Menentukan penunjuk ke pengidentifikasi peristiwa yang didaftarkan aplikasi. Lihat Pengidentifikasi Peristiwa WIA untuk pengidentifikasi peristiwa standar.

pIWiaEventCallback [in]

Jenis: IWiaEventCallback*

Menentukan pointer ke antarmuka IWiaEventCallback yang digunakan WIA 2.0 untuk mengirim pemberitahuan peristiwa.

pEventObject [out]

Jenis: IUnknown**

Menerima alamat pointer ke antarmuka IUnknown .

Nilai kembali

Jenis: HRESULT

Mengembalikan kode kesalahan COM standar atau yang berikut ini.

Menampilkan kode	Deskripsi
E_NOTIMPL	Antarmuka IUnknown tidak dapat dikembalikan.

 

Keterangan

Peringatan

Menggunakan metode IWiaDevMgr::RegisterEventCallbackInterface, IWiaDevMgr2::RegisterEventCallbackInterface, dan DeviceManager.RegisterEvent dari proses yang sama setelah Still Image Service dimulai ulang dapat menyebabkan pelanggaran akses, jika fungsi digunakan sebelum layanan dihentikan.

 

Ketika aplikasi WIA 2.0 mulai dieksekusi, mereka menggunakan metode ini untuk mendaftar untuk menerima peristiwa perangkat keras. Ini mencegah aplikasi dimulai ulang ketika peristiwa lain yang terdaftar terjadi. Setelah aplikasi memanggil IWiaDevMgr2::RegisterEventCallbackInterface untuk mendaftarkan dirinya untuk menerima peristiwa WIA 2.0 dari perangkat, peristiwa terdaftar dirutekan ke program oleh WIA 2.0.

Aplikasi harus memanggil metode IUnknown::Release pada pointer antarmuka yang mereka terima melalui parameter pEventObject .

Catatan

Dalam aplikasi multithreaded, panggilan balik pemberitahuan peristiwa mungkin masuk pada utas yang berbeda dari 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
IDL	Wia.idl