IWiaTransferCallback::TransferCallback 메서드(wia_lh.h)

IWiaTransferCallback::TransferCallback 메서드는 이미지 처리 필터에 의해 구현됩니다. IWiaTransfer::D ownload 또는 미리 보기 구성 요소의 IWiaPreview::GetNewPreview를 호출하는 애플리케이션의 결과로 WIA 서비스에서 호출됩니다.

구문

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

매개 변수

[in] lFlags

현재 사용되지 않습니다. 0으로 설정해야 합니다.

[in] pWiaTransferParams

WiaTransferParams 구조체에 대한 포인터를 지정합니다.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 표준 COM 오류 값을 반환합니다.

설명

이미지 가져오기 중에 WIA 미니 드라이버가 클라이언트에서 대상 스트림을 요청하고 미니 드라이버가 진행률 메시지를 애플리케이션으로 다시 보낼 때 이미지 처리 필터의 IWiaTransferCallback::TransferCallback 메서드 구현이 호출됩니다.

이미지 처리 필터의 IWiaTransferCallback::TransferCallback 메서드는 애플리케이션 콜백의 IWiaTransferCallback::TransferCallback 메서드에 위임해야 합니다. 대부분의 경우 이미지 처리 필터의 IWiaTransferCallback::TransferCallback 구현은 ulBytesWrittenToCurrentStream 및 WiaTransferParams 구조의 lPercentComplete 값도 수정해야 합니다. 이미지 처리 필터가 애플리케이션 제공 스트림에 데이터를 쓰기 전에 Write 메서드 호출 간에 이미지 데이터를 버퍼링해야 하는 경우 ulBytesWrittenToCurrentStream을 수정해야 합니다. 예를 들어 이 작업을 수행하는 경우 deskewing 및/또는 회전이 필요합니다. 회전이나 책상이 필요하지 않은 경우 필터가 데이터 대역에서 작동하는 것이 좋습니다. 그러나 이 매개 변수는 총 전송 시간의 백분율을 나타내기 때문에 lPercentComplete를 반드시 수정할 필요는 없습니다. 예를 들어 이 멤버는 애플리케이션의 진행률 표시줄에서 사용할 수 있습니다. 이미지 처리 필터는 구조체의 lMessage 멤버를 수정해서는 안 됩니다. IWiaTransferCallback::TransferCallback 은 버퍼링을 수행하더라도 수신하는 메시지를 "삼켜서는 안 됩니다" 대신 ulBytesWrittenToCurrentStream 멤버를 수정해야 합니다.

이 메서드는 IWiaPreview::UpdatePreview 중에 미리 보기 구성 요소에서 호출되지 않습니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	wia_lh.h(Wia_lh.h 포함)