IWiaTransferCallback::GetNextStream method (wia_lh.h)
Metode IWiaTransferCallback::GetNextStream diimplementasikan oleh filter pemrosesan gambar. Ini dipanggil oleh layanan WIA sebagai hasil dari aplikasi yang memanggil IWiaTransfer::D ownload atau komponen pratinjau IWiaPreview::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview).
Sintaks
HRESULT GetNextStream(
[in] LONG lFlags,
[in] BSTR bstrItemName,
[in] BSTR bstrFullItemName,
[out] IStream **ppDestination
);
Parameter
[in] lFlags
Dicadangkan, atur ke nol.
[in] bstrItemName
Menentukan string yang berisi nama item.
[in] bstrFullItemName
Menentukan string yang berisi nama lengkap item.
[out] ppDestination
Menentukan penunjuk ke aliran output.
Nilai kembali
Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM standar jika tidak.
Keterangan
Implementasi filter pemrosesan gambar dari IWiaTransferCallback::GetNextStream dan 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.
Implementasi filter pemrosesan gambar dari IWiaTransferCallback::GetNextStream harus mendelegasikan ke metode IWiaTransferCallback::GetNextStream aplikasi. Filter pemrosesan gambar kemudian menggunakan aliran yang dikembalikan oleh implementasi IWiaTransferCallback::GetNextStream dari aplikasi untuk membuat alirannya sendiri ("aliran pemfilteran") yang diteruskan kembali ke layanan WIA.
Dalam implementasi IWiaTransferCallback::GetNextStream , filter pemrosesan gambar harus membaca properti mana yang diperlukan untuk pemrosesan gambarnya dari item tempat gambar diperoleh. Filter tidak boleh membaca properti langsung dari pWiaItem2 yang diteruskan ke IWiaImageFilter::InitializeFilter; melainkan harus memanggil IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) pada item WIA ini untuk mendapatkan item WIA yang sebenarnya. Alasannya adalah bahwa selama folder mentransfer gambar yang diperoleh sesuai dengan item anak pWiaItem2 daripada ke pWiaItem2 itu sendiri.
Metode ini tidak dipanggil oleh komponen pratinjau selama IWiaPreview::UpdatePreview.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wia_lh.h (termasuk Wia_lh.h) |