IWiaTransferCallback::Metode GetNextStream

Artikel
06/13/2023

Mendapatkan aliran baru untuk item yang ditentukan.

Sintaks

HRESULT GetNextStream(
  [in]  LONG    lFlags,
  [in]  BSTR    bstrItemName,
  [in]  BSTR    bstrFullItemName,
  [out] IStream **ppDestination
);

Parameter

lFlags [in]

Jenis: LONG

Saat ini tidak digunakan. Harus diatur ke nol.

bstrItemName [in]

Jenis: BSTR

Menentukan nama item yang akan dibuat alirannya.

bstrFullItemName [in]

Jenis: BSTR

Menentukan nama lengkap item yang akan dibuat alirannya.

ppDestination [out]

Jenis: IStream**

Menerima alamat penunjuk ke objek IStream baru.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ketika metode ini diimplementasikan oleh filter pemrosesan gambar, minidriver Windows Image Acquisition (WIA) 2.0 memanggilnya selama akuisisi gambar untuk mendapatkan aliran tujuan dari klien.

IWiaTransferCallback::GetNextStream filter harus mendelegasikan ke metode panggilan balik aplikasi. Filter menggunakan aliran yang dikembalikan oleh implementasi IWiaTransferCallback::GetNextStream panggilan balik aplikasi untuk membuat alirannya sendiri yang diteruskan kembali ke layanan WIA 2.0. Pemfilteran dilakukan ketika aliran filter memanggil metode IStream::Write .

Aliran filter tidak dapat membuat asumsi apa pun pada jumlah byte yang ditulis pada setiap tulisan, karena data gambar yang tidak difilter mungkin berasal dari Komponen Pratinjau WIA 2.0 daripada driver. Komponen Pratinjau WIA 2.0 selalu menulis seluruh data gambar yang tidak difilter ke dalam aliran filter hanya sekali, yang berarti bahwa aliran filter memiliki satu penulisan sumber ke dalamnya. Jika driver dan komponen pratinjau menulis ke aliran filter, aliran filter tidak dapat mengasumsikan, misalnya, bahwa ia akan menerima header lengkap pertama kali IStream::Write dipanggil meskipun driver yang sesuai selalu menulis data header terlebih dahulu dalam satu tulis. Juga tidak dapat mengasumsikan bahwa tulisan berikutnya berisi tepat satu baris pemindaian. Jadi aliran pemfilteran mungkin harus menghitung jumlah byte yang ditulis untuk menentukan, misalnya, di mana data gambar dimulai.

Implementasi IWiaTransferCallback::GetNextStream filter pemrosesan gambar harus membaca properti yang diperlukan untuk pemrosesan gambarnya dari item tempat gambar diperoleh. Filter tidak membaca properti langsung dari pWiaItem2 yang diteruskan ke InitializeFilter. Sebagai gantinya, filter harus memanggil FindItemByName pada item WIA 2.0 ini untuk mendapatkan item WIA 2.0 yang sebenarnya. Alasan untuk ini adalah bahwa gambar yang diperoleh mungkin benar-benar merupakan item anak dari pWiaItem2. Misalnya, selama akuisisi folder, filter menggunakan pWiaItem2 untuk mendapatkan item anak pWiaItem2 di IWiaTransferCallback::GetNextStream (selama akuisisi folder driver mengembalikan gambar yang diwakili oleh item anak pWiaItem2). Hal yang sama berlaku ketika Komponen Pratinjau WIA 2.0 memanggil ke filter pemrosesan gambar yang meneruskan item WIA 2.0 anak.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Wia.h
IDL	Wia.idl
Pustaka	Wiaguid.lib

Share via