Metode IWiaMiniDrvCallBack::MiniDrvCallback (wiamindr_lh.h)
Metode MiniDrvCallback menyediakan metode panggilan balik untuk digunakan oleh minidriver WIA selama transfer data panggilan balik.
Sintaks
HRESULT MiniDrvCallback(
[in] LONG lReason,
[in] LONG lStatus,
[in] LONG lPercentComplete,
[in] LONG lOffset,
[in] LONG lLength,
[in] PMINIDRV_TRANSFER_CONTEXT pTranCtx,
[in] LONG lReserved
);
Parameter
[in] lReason
Menentukan nilai konstanta yang menunjuk pesan status panggilan balik. Nilai ini digunakan untuk menentukan tujuan panggilan balik, dan bisa menjadi salah satu nilai berikut:
| Pesan | Definisi |
|---|---|
| IT_MSG_DATA | Menunjukkan bahwa buffer transfer berisi blok data. |
| IT_MSG_DATA_HEADER | Diterima sebelum transfer data apa pun. Menunjukkan bahwa buffer transfer menunjuk ke struktur WIA_DATA_CALLBACK_HEADER yang menentukan elemen transfer data. |
| IT_MSG_DEVICE_STATUS | Panggilan balik hanya berisi informasi status tentang perangkat. |
| IT_MSG_FILE_PREVIEW_DATA | Menunjukkan data pratinjau sedang ditransfer ke aplikasi. |
| IT_MSG_FILE_PREVIEW_DATA_HEADER | Menunjukkan header sedang ditransfer ke aplikasi, sebelum data pratinjau ditransfer. |
| IT_MSG_NEW_PAGE | Menunjukkan bahwa transfer data halaman selesai, dan halaman baru sedang dikirim. |
| IT_MSG_STATUS | Panggilan balik hanya berisi informasi status tentang transfer. |
| IT_MSG_TERMINATION | Menunjukkan bahwa transfer data selesai. |
[in] lStatus
Menentukan status transfer. Parameter ini adalah bitwise ATAU dari nilai berikut:
| Status | Definisi |
|---|---|
| IT_STATUS_TRANSFER_FROM_DEVICE | Mentransfer data dari perangkat. |
| IT_STATUS_PROCESSING_DATA | Perangkat dan/atau minidriver sedang memproses data. |
| IT_STATUS_TRANSFER_TO_CLIENT | Mentransfer data dari minidriver ke layanan WIA. |
[in] lPercentComplete
Menentukan persentase data saat ini yang ditransfer.
[in] lOffset
Menentukan offset saat ini (dalam byte) ke dalam buffer transfer dari awal buffer.
[in] lLength
Menentukan jumlah byte yang terkandung dalam transfer.
[in] pTranCtx
Menunjuk ke struktur MINIDRV_TRANSFER_CONTEXT yang berisi nilai transfer data.
[in] lReserved
Dicadangkan. Atur ke nol.
Mengembalikan nilai
Jika metode berhasil, metode akan mengembalikan S_OK. Jika panggilan balik dibatalkan oleh aplikasi klien, metode mengembalikan S_FALSE. Jika metode gagal, metode mengembalikan kode kesalahan COM standar.
Keterangan
Persentase nilai lengkap dikirim langsung dari driver. Layanan WIA tidak menyesuaikan nilai.
IT_MSG_FILE_PREVIEW_DATA_HEADER adalah untuk out-of-band-data. Ini memungkinkan aplikasi melakukan transfer file untuk menampilkan data bersalur. Ini berguna untuk pemindai scroll-fed yang memiliki panjang tidak diketahui dan tidak ada pemindaian pratinjau. Informasi yang dilaporkan dalam pesan ini harus diperlakukan sama dengan IT_MSG_DATA_HEADER. Jika driver mendukung pesan ini, driver dapat menyediakan data pratinjau selama transfer filenya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |