共用方式為


IWiaImageFilter::InitializeFilter 方法 (wia_lh.h)

IWiaImageFilter::InitializeFilter 方法會儲存傳遞給 方法的 pWiaItem2pWiaTransferCallback 參數的參考。

語法

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

參數

[in] pWiaItem2

指向應用程式起始影像擷取的 IWiaItem2 專案。 在 IWiaTransfer::D ownload 的情況下,它是我們從中取得 IWiaTransfer 介面的 WIA 專案,而且在預覽元件的情況下,它是我們傳入 IWiaPreview::GetNewPreview 方法的專案。

[in] pWiaTransferCallback

指向 IWiaTransferCallback 介面。 IWiaTransferCallback 介面是應用程式的回呼介面,它會傳遞至 IWiaTransfer::D ownloadIWiaPreview::GetNewPreview

傳回值

傳回成功時S_OK,或在失敗時傳回標準 COM 錯誤碼。

備註

在下載呼叫到達 WIA 服務之前,COM Proxy 物件會呼叫這個方法。 這發生在兩種情況下:當應用程式呼叫 IWiaTransfer::D ownload 方法,以及應用程式呼叫 IWiaPreview::GetNewPreview 方法時。

IWiaImageFilter::InitializeFilter 只需要儲存傳入它的 pWiaItem2pWiaTransferCallback 的參考。 這些介面指標應該儲存為這個方法中的成員變數,而且應該針對每個介面指標呼叫 AddRef 。 在篩選條件的 IWiaTransferCallback::TransferCallback::TransferCallbackIWiaTransferCallback::GetNextStream 方法實作中需要這兩個介面指標。

應用程式無法直接叫用這個方法。

規格需求

需求
目標平台 桌面
標頭 wia_lh.h (包含 Wia_lh.h)

另請參閱

IWiaImageFilter

IWiaItem2

IWiaPreview::GetNewPreview

IWiaTransferCallback

IWiaTransfer::D ownload