IWiaImageFilter::InitializeFilter 方法 (wia_lh.h)
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::TransferCallback 和 IWiaTransferCallback::GetNextStream 方法實作中需要這兩個介面指標。
應用程式無法直接叫用這個方法。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | wia_lh.h (包含 Wia_lh.h) |