Metode IWiaDevMgr::RegisterEventCallbackInterface (wia_xp.h)

Artikel
03/13/2024

Metode IWiaDevMgr::RegisterEventCallbackInterface mendaftarkan pemberitahuan peristiwa Windows Image Acquisition (WIA) aplikasi yang sedang berjalan.

Sintaks

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

Parameter

[in] lFlags

Jenis: LONG

Saat ini tidak digunakan. Harus diatur ke nol.

[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] pIWiaEventCallback

Jenis: IWiaEventCallback*

Arahkan ke antarmuka IWiaEventCallback yang digunakan sistem WIA untuk mengirim pemberitahuan peristiwa.

[out] pEventObject

Jenis: IUnknown**

Menerima alamat pointer ke antarmuka IUnknown .

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan 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 mereka mulai mengeksekusi, aplikasi WIA menggunakan metode ini untuk mendaftar untuk menerima peristiwa perangkat keras jenis WIA_NOTIFICATION_EVENT. Ini mencegah aplikasi dimulai ulang ketika peristiwa lain yang terdaftar terjadi. Setelah program memanggil IWiaDevMgr::RegisterEventCallbackInterface untuk mendaftarkan dirinya untuk menerima peristiwa WIA dari perangkat, peristiwa terdaftar dirutekan ke program oleh sistem WIA.

Aplikasi menggunakan metode EnumRegisterEventInfo untuk mengambil pointer ke objek enumerator untuk properti 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.

Aplikasi dapat membatalkan pendaftaran peristiwa dengan menggunakan pointer IUnknown yang dikembalikan melalui parameter pEventObject untuk memanggil metode IUnknown::Release .

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

Bagikan melalui