fungsi wiasWritePageBufToFile (wiamdef.h)
Fungsi wiasWritePageBufToFile menulis konten buffer halaman sementara ke file gambar.
Sintaks
HRESULT wiasWritePageBufToFile(
[in] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
Parameter
[in] pmdtc
Penunjuk ke struktur MINIDRV_TRANSFER_CONTEXT .
Nilai kembali
Setelah berhasil, fungsi mengembalikan S_OK. Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kesalahan WIA_ERROR_XXX (dijelaskan dalam dokumentasi Microsoft Windows SDK).
Keterangan
Fungsi ini menulis data dari buffer halaman sementara yang dialokasikan minidriver ke file gambar yang dibuka oleh layanan WIA. Minidriver biasanya memanggil fungsi ini setelah memperoleh halaman data tempat minidriver mengalokasikan buffer sementara.
Fungsi ini mirip dengan wiasWriteBufToFile, yang dapat digunakan untuk menulis buffer data gambar ke semua jenis file gambar. Jika minidriver WIA berniat menulis halaman data gambar ke file TIFF multipage, termasuk semua tag yang sesuai, entri direktori file gambar (IFD), dan data nonimage lainnya, itu harus memanggil fungsi ini, daripada wiasWriteBufToFile.
Ekspresi pmdtc-hFile> berisi handel ke file dalam transfer TYMED_FILE (dan TYMED_MULTIPAGE_FILE). Ini dapat digunakan untuk langsung mengakses file yang sedang ditulis.
Contoh cara menggunakannya adalah:
SetFilePointer((HANDLE)(LONG_PTR)pmdtc->hFile,0,NULL,FILE_BEGIN);
if (!WriteFile((HANDLE)(LONG_PTR)pmdtc->hFile,
pMyBuffer,
dwNumBytesToWrite,
&dwNumBytesWritten,
NULL)) {
//
// Some error happened
//
.
.
.
}
Namun, jika Anda hanya mempertimbangkan untuk menggunakan handel file di transfer TYMED_FILE dan TYMED_MULTIPAGE_FILE Anda (untuk menulis data langsung ke file menggunakan handel file, alih-alih memanggil wiasWritePageBufToFile), gunakan wiasWriteBufToFile. Fungsi ini memiliki performa yang setara dengan:
bRet = WriteFile((HANDLE)ULongToPtr(pmdtc->hFile),
pmdtc->pTransferBuffer,
pmdtc->lItemSize,
&ulWritten,
NULL);
Ini pada dasarnya adalah apa yang akan Anda lakukan jika Anda menggunakan handel file secara langsung. Keuntungan dari contoh pertama adalah bahwa jika implementasi diubah dalam rilis WIA di masa mendatang (misalnya, jika layanan WIA mulai menggunakan pipa alih-alih file, secara internal), driver tidak perlu diperbarui.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows Me dan di Windows XP dan versi sistem operasi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | wiamdef.h (termasuk Wiamdef.h) |
| Pustaka | Wiaservc.lib |
| DLL | Wiaservc.dll |