IWiaImageFilter::InitializeFilter 메서드(wia_lh.h)

아티클
03/08/2023

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 프록시 개체에 의해 호출됩니다. 애플리케이션이 IWiaTransfer::D ownload 메서드를 호출하고 애플리케이션이 IWiaPreview::GetNewPreview 메서드를 호출하는 경우 두 가지 경우에 발생합니다.

IWiaImageFilter::InitializeFilter가 수행해야 하는 작업은 전달되는 pWiaItem2 및 pWiaTransferCallback에 대한 참조를 저장하는 것입니다. 이러한 인터페이스 포인터는 이 메서드에서 멤버 변수로 저장되어야 하며 각 인터페이스 포인터에 대해 AddRef 를 호출해야 합니다. 이러한 두 인터페이스 포인터는 필터의 IWiaTransferCallback::TransferCallback 및 IWiaTransferCallback::GetNextStream 메서드 구현에 필요합니다.

이 메서드는 애플리케이션에서 직접 호출할 수 없습니다.