Metode IWiaMiniDrvTransferCallback::GetNextStream (wiamindr_lh.h)

Artikel
02/27/2024

Dipanggil oleh driver mini WIA untuk mendapatkan aliran untuk transfer data saat ini (unduh atau unggah).

Sintaks

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

Parameter

[in] lFlags

Mewakili bit bendera. Parameter ini tidak digunakan dan harus selalu diatur ke nol (0) oleh pemanggil.

[in] bstrItemName

Nama item yang akan melakukan transfer data.

Untuk informasi selengkapnya, lihat WIA_IPA_ITEM_NAME.

[in] bstrFullItemName

Nama lengkap item yang akan melakukan transfer data.

Untuk informasi selengkapnya, lihat WIA_IPA_FULL_ITEM_NAME.

[out] ppIStream

Penunjuk ke objek IStream .

Mengembalikan nilai

Metode ini mengembalikan S_OK ketika panggilan berhasil. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ketika klien meminta untuk melewati transfer data, metode GetNextStream mengembalikan WIA_STATUS_SKIP_ITEM. Driver mini WIA harus melewati transfer gambar saat ini dan melanjutkan transfer gambar berikutnya, jika ada. Misalnya, untuk transfer unduhan, selesaikan pemindaian gambar saat ini lalu buang data gambar.

Ketika urutan transfer saat ini dibatalkan, metode GetNextStream mengembalikan S_FALSE.