IWiaImageFilter::InitializeFilter 方法會將 pWiaItem2 和 pWiaTransferCallback 參數的參考儲存至 方法。
語法
HRESULT InitializeFilter(
[in] IWiaItem2 *pWiaItem2,
[in] IWiaTransferCallback *pWiaTransferCallback
);
參數
[in] pWiaItem2
指向應用程式起始影像擷取的 IWiaItem2 專案。 在 IWiaTransfer::D ownload的情況下,它是從中取得 IWiaTransfer 介面的 WIA 專案,而在預覽元件的情況下,它是我們傳入 IWiaPreview::GetNewPreview 方法的專案。
[in] pWiaTransferCallback
指向 IWiaTransferCallback介面。 IWiaTransferCallback 介面是應用程式的回呼介面,它會傳遞至 IWiaTransfer::D ownload 和 IWiaPreview::GetNewPreview。
傳回值
傳回成功時S_OK,或失敗時的標準 COM 錯誤碼。
言論
下載呼叫到達 WIA 服務之前,COM Proxy 物件會呼叫此方法。 這種情況發生在兩種情況下:當應用程式呼叫 IWiaTransfer::D ownload 方法,以及當應用程式呼叫 IWiaPreview::GetNewPreview 方法時。
必須執行 IWiaImageFilter::InitializeFilter 的所有作業,就是儲存傳入 它的 pWiaItem2 和 pWiaTransferCallback 的參考。 這些介面指標應該儲存為此方法中的成員變數,而且應該為每個介面指標呼叫 addRef 。 在篩選的 IWiaTransferCallback::TransferCallback和 IWiaTransferCallback::GetNextStream 方法的實作中,需要這兩個介面指標。
應用程式無法直接叫用這個方法。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | wia_lh.h (包括 Wia_lh.h) |