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 오류 값을 반환합니다.

발언

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

이미지 처리 필터의 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 포함)