Metode IWiaEventCallback::ImageEventCallback (wia_xp.h)

Metode IWiaEventCallback::ImageEventCallback dipanggil oleh sistem run-time Windows Image Acquisition (WIA) ketika peristiwa perangkat keras terjadi.

Sintaks

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

Parameter

[in] pEventGUID

Jenis: const GUID*

Menentukan pengidentifikasi unik peristiwa. Untuk daftar lengkap peristiwa perangkat, lihat Pengidentifikasi Peristiwa WIA.

[in] bstrEventDescription

Jenis: BSTR

Menentukan deskripsi string peristiwa.

[in] bstrDeviceID

Jenis: BSTR

Menentukan pengidentifikasi unik perangkat WIA.

[in] bstrDeviceDescription

Jenis: BSTR

Menentukan deskripsi string perangkat.

[in] dwDeviceType

Jenis: DWORD

Menentukan jenis perangkat. Lihat Penentu Jenis Perangkat WIA untuk daftar nilai yang mungkin.

[in] bstrFullItemName

Jenis: BSTR

Menentukan nama lengkap item WIA yang mewakili perangkat.

[in, out] pulEventType

Jenis: ULONG*

Penunjuk ke ULONG yang menentukan apakah peristiwa adalah peristiwa pemberitahuan, peristiwa tindakan, atau keduanya. Nilai 1 menunjukkan peristiwa pemberitahuan, nilai 2 menunjukkan peristiwa tindakan, dan nilai 3 menunjukkan bahwa peristiwa tersebut berdasarkan jenis pemberitahuan dan tindakan.

[in] ulReserved

Jenis: ULONG

Dicadangkan untuk informasi pengguna.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Untuk menerima pemberitahuan peristiwa perangkat keras WIA, aplikasi meneruskan pointer ke antarmuka IWiaEventCallback ke metode RegisterEventCallbackInterface . Sistem run-time WIA kemudian menggunakan penunjuk antarmuka tersebut untuk memanggil metode IWiaEventCallback::ImageEventCallback setiap kali peristiwa perangkat keras WIA terjadi.

Perhatikan bahwa tidak ada jaminan panggilan balik akan dipanggil pada utas yang sama yang mendaftarkan antarmuka IWiaEventCallback .

Persyaratan

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