IWiaTransferCallback::Metode TransferCallback (wia_lh.h)

Metode IWiaTransferCallback::TransferCallback diimplementasikan oleh filter pemrosesan gambar. Ini dipanggil oleh layanan WIA sebagai hasil dari aplikasi yang memanggil IWiaTransfer::D ownload atau komponen pratinjau IWiaPreview::GetNewPreview.

Sintaks

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

Parameter

[in] lFlags

Saat ini tidak digunakan. Harus diatur ke nol.

[in] pWiaTransferParams

Menentukan penunjuk ke struktur WiaTransferParams .

Nilai kembali

Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM standar sebaliknya.

Keterangan

Implementasi filter pemrosesan gambar dari metode IWiaTransferCallback::TransferCallback dipanggil selama akuisisi gambar, ketika driver mini WIA meminta aliran tujuan dari klien dan ketika driver mini mengirim pesan kemajuan kembali ke aplikasi.

Metode IWiaTransferCallback::TransferCallback filter pemrosesan gambar harus mendelegasikan ke metode IWiaTransferCallback::TransferCallback panggilan balik aplikasi. Dalam banyak kasus, implementasi IWiaTransferCallback::TransferCallback filter pemrosesan gambar juga harus memodifikasi ulBytesWrittenToCurrentStream dan mungkin juga nilai lPercentComplete dalam struktur WiaTransferParams. ulBytesWrittenToCurrentStream harus dimodifikasi jika filter pemrosesan gambar harus menyangga data gambar antara panggilan ke metode Tulis sebelum menulis data ke aliran yang disediakan aplikasi. Ini akan, misalnya, diperlukan jika deskewing dan/atau rotasi jika sedang dilakukan. Jika tidak ada rotasi atau deskewing yang diperlukan, filter sebaiknya bekerja pada pita data. lPercentComplete tidak selalu perlu dimodifikasi, namun, karena parameter ini menunjukkan persentase total waktu transfer. Anggota ini misalnya dapat digunakan oleh bilah kemajuan dalam aplikasi. Perhatikan bahwa filter pemrosesan gambar tidak boleh mengubah anggota lMessage dari struktur. IWiaTransferCallback::TransferCallback juga tidak boleh "menelan" pesan apa pun yang diterimanya bahkan jika melakukan buffering, melainkan harus memodifikasi anggota ulBytesWrittenToCurrentStream .

Metode ini tidak dipanggil oleh komponen pratinjau selama IWiaPreview::UpdatePreview.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	wia_lh.h (termasuk Wia_lh.h)