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 |