fungsi wiasQueueEvent (wiamdef.h)
Fungsi wiasQueueEvent menginformasikan layanan bahwa perangkat menghasilkan peristiwa.
Sintaks
HRESULT wiasQueueEvent(
[in] BSTR bstrDeviceId,
[in] const GUID *pEventGUID,
[in, optional] BSTR bstrFullItemName
);
Parameter
[in] bstrDeviceId
Menentukan ID perangkat. Ini adalah nilai yang diteruskan ke minidriver dalam panggilan ke metode IWiaMiniDrv::d rvInitializeWia .
[in] pEventGUID
Penunjuk ke buffer yang berisi GUID untuk peristiwa tersebut.
[in, optional] bstrFullItemName
Menentukan nama item lengkap, termasuk informasi jalur.
Nilai kembali
Jika berhasil, fungsi mengembalikan S_OK.
Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kode kesalahan WIA.
Keterangan
Metode ini harus digunakan setiap kali perangkat harus memberi sinyal bahwa peristiwa dari beberapa jenis terjadi. Perangkat melakukan ini dengan menempatkan peristiwa pada antrean peristiwa. Misalnya, ketika kamera mengambil gambar baru, kamera harus menghasilkan peristiwa WIA_EVENT_ITEM_CREATED setelah menambahkan item driver baru ke pohonnya. Kamera dapat menempatkan peristiwa ini pada antrean peristiwa dengan cara ini:
hr = wiasQueueEvent(bstrMyDeviceId,
&WIA_EVENT_ITEM_CREATED,
bstrDescriptionString);
Lihat dokumentasi Windows SDK untuk daftar lengkap pengidentifikasi peristiwa WIA.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamdef.h (termasuk Wiamdef.h) |
| Pustaka | Wiaservc.lib |
| DLL | Wiaservc.dll |