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

IWiaTransferCallback::GetNextStream 메서드는 이미지 처리 필터에 의해 구현됩니다. IWiaTransfer::D ownload 또는 미리 보기 구성 요소의 IWiaPreview::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview)를 호출하는 애플리케이션의 결과로 WIA 서비스에서 호출됩니다.

구문

HRESULT GetNextStream(
  [in]  LONG    lFlags,
  [in]  BSTR    bstrItemName,
  [in]  BSTR    bstrFullItemName,
  [out] IStream **ppDestination
);

매개 변수

[in] lFlags

예약되어 있으며 0으로 설정됩니다.

[in] bstrItemName

항목의 이름을 포함하는 문자열을 지정합니다.

[in] bstrFullItemName

항목의 전체 이름을 포함하는 문자열을 지정합니다.

[out] ppDestination

출력 스트림에 대한 포인터를 지정합니다.

반환 값

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

설명

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

IWiaTransferCallback::GetNextStream의 이미지 처리 필터 구현은 애플리케이션의 IWiaTransferCallback::GetNextStream 메서드에 위임해야 합니다. 그런 다음 이미지 처리 필터는 애플리케이션 콜백의 IWiaTransferCallback::GetNextStream 구현에서 반환된 스트림을 사용하여 WIA 서비스로 다시 전달하는 자체 스트림("필터링 스트림")을 만듭니다.

IWiaTransferCallback::GetNextStream 구현에서 이미지 처리 필터는 이미지를 가져오는 항목에서 이미지 처리에 필요한 속성을 읽어야 합니다. 필터는 IWiaImageFilter::InitializeFilter에 전달된 pWiaItem2에서 직접 속성을 읽지 않아야 합니다. 실제 WIA 항목을 가져오려면 이 WIA 항목에서 IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname)을 호출해야 합니다. 그 이유는 폴더 전송 중에 획득한 이미지가 pWiaItem2 자체가 아닌 pWiaItem2의 자식 항목에 해당 하기 때문입니다.

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

요구 사항

추가 정보

IWiaImageFilter::InitializeFilter

IWiaTransferCallback