IWiaImageFilter::InitializeFilter method (wia_lh.h)

Artikel
02/27/2024

Metode IWiaImageFilter::InitializeFilter menyimpan referensi ke parameter pWiaItem2 dan pWiaTransferCallback yang diteruskan ke metode .

Sintaks

HRESULT InitializeFilter(
  [in] IWiaItem2            *pWiaItem2,
  [in] IWiaTransferCallback *pWiaTransferCallback
);

Parameter

[in] pWiaItem2

Menunjuk ke item IWiaItem2 tempat akuisisi gambar dimulai oleh aplikasi. Dalam kasus IWiaTransfer::D ownload, itu adalah item WIA tempat kami mendapatkan antarmuka IWiaTransfer , dan dalam kasus komponen Pratinjau, itu adalah item yang kami teruskan ke metode IWiaPreview::GetNewPreview .

[in] pWiaTransferCallback

Menunjuk ke antarmuka IWiaTransferCallback . Antarmuka IWiaTransferCallback adalah antarmuka panggilan balik aplikasi, yang diteruskan ke IWiaTransfer::D ownload dan IWiaPreview::GetNewPreview.

Nilai kembali

Mengembalikan S_OK pada keberhasilan, atau kode kesalahan COM standar pada kegagalan.

Keterangan

Metode ini dipanggil oleh objek proksi COM sebelum panggilan unduhan mencapai layanan WIA. Ini terjadi dalam dua kasus: ketika aplikasi memanggil metode IWiaTransfer::D ownload dan ketika aplikasi memanggil metode IWiaPreview::GetNewPreview .

Semua yang harus dilakukan IWiaImageFilter::InitializeFilter adalah menyimpan referensi ke pWiaItem2 dan pWiaTransferCallback yang diteruskan ke dalamnya. Penunjuk antarmuka ini harus disimpan sebagai variabel anggota dalam metode ini dan AddRef harus dipanggil untuk setiap penunjuk antarmuka. Kedua penunjuk antarmuka ini diperlukan dalam implementasi filter dari metode IWiaTransferCallback::TransferCallback dan IWiaTransferCallback::GetNextStream .

Metode ini tidak dapat dipanggil langsung oleh aplikasi.