共用方式為


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 ownloadIWiaPreview::GetNewPreview

傳回值

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

言論

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

必須執行 IWiaImageFilter::InitializeFilter 的所有作業,就是儲存傳入 它的 pWiaItem2pWiaTransferCallback 的參考。 這些介面指標應該儲存為此方法中的成員變數,而且應該為每個介面指標呼叫 addRef 。 在篩選的 IWiaTransferCallback::TransferCallbackIWiaTransferCallback::GetNextStream 方法的實作中,需要這兩個介面指標。

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

要求

要求 價值
目標平臺 桌面
標頭 wia_lh.h (包括 Wia_lh.h)

另請參閱

IWiaImageFilter

IWiaItem2

IWiaPreview::GetNewPreview

IWiaTransferCallback

IWiaTransfer::D ownload