IWiaDataTransfer::idtGetData 메서드(wia_xp.h)

IWiaDataTransfer::idtGetData 메서드는 WIA(Windows Image Acquisition) 디바이스에서 전체 파일을 검색합니다.

구문

HRESULT idtGetData(
  [in, out] LPSTGMEDIUM      pMedium,
  [in]      IWiaDataCallback *pIWiaDataCallback
);

매개 변수

[in, out] pMedium

형식: LPSTGMEDIUM

STGMEDIUM 구조체에 대한 포인터입니다.

[in] pIWiaDataCallback

형식: IWiaDataCallback*

IWiaDataCallback 인터페이스에 대한 포인터입니다.

반환 값

형식: HRESULT

이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

반환 값	의미
E_INVALIDARG	이 메서드에 대한 하나 이상의 매개 변수에 잘못된 데이터가 포함되어 있습니다.
E_OUTOFMEMORY	이 메서드는 작업을 완료하기에 충분한 메모리를 할당할 수 없습니다.
E_UNEXPECTED	알 수 없는 오류가 발생했습니다.
S_FALSE	애플리케이션이 작업을 취소했습니다.
S_OK	이미지를 성공적으로 획득했습니다.
STG_E_MEDIUMFULL	애플리케이션이 이미지를 획득하는 데 사용하는 스토리지 매체가 가득 찼습니다.
WIA_S_NO_DEVICE_AVAILABLE	사용자의 컴퓨터에 연결된 WIA 하드웨어 디바이스가 없습니다.

 

이 메서드는 오류 코드에 지정된 값을 반환하거나 앞의 표에 지정된 값 이외의 이유로 실패하는 경우 표준 COM 오류를 반환합니다.

설명

대부분의 경우 이 메서드는 IDataObject::GetData 메서드와 동일하게 작동합니다. 주요 차이점은 IWiaDataTransfer::idtGetData 가 IWiaDataCallback 인터페이스에 대한 포인터에 대한 추가 매개 변수를 제공한다는 것입니다. 애플리케이션은 이 선택적 매개 변수를 사용하여 데이터 전송 중에 상태 알림을 받습니다. 상태 알림이 필요하지 않은 경우 0으로 설정해야 합니다.

데이터 전송 형식은 항목의 WIA_IPA_FORMAT 및 WIA_IPA_TYMED 속성 값에 따라 결정됩니다. 애플리케이션은 IWiaPropertyStorage::WriteMultiple 메서드를 호출하여 이러한 속성을 설정합니다.

IWiaDataTransfer::idtGetBandedData 메서드와 달리 IWiaDataTransfer::idtGetData는 단일 데이터 밴드가 아닌 WIA 디바이스에서 애플리케이션으로 전체 파일을 전송합니다. pMedium 매개 변수는 데이터 전송에 사용할 스토리지 매체에 대한 정보를 포함하는 STGMEDIUM 구조체에 대한 포인터입니다. 프로그램은 pIWiaDataCallback 매개 변수를 사용하여 이 메서드를 IWiaDataCallback 인터페이스에 대한 포인터를 전달합니다. 이 메서드는 주기적으로 인터페이스 포인터를 사용하여 BandedDataCallback 메서드를 호출하고 진행 중인 데이터 전송에 대한 상태 정보를 애플리케이션에 제공합니다.

WIA가 새 파일의 파일 이름과 위치를 확인할 수 있도록 pMedium 구조체의 lpszFileName 멤버 값으로 NULL을 전달합니다. 반환 시 pMedium 구조체의 lpszFileName 멤버에는 새 파일의 위치와 이름이 포함됩니다.

이 메서드에서 반환된 값이 COM SUCCESS 값이거나 전송이 다중 페이지 파일 전송이고 반환된 오류 코드가 WIA_ERROR_PAPER_JAM, WIA_ERROR_PAPER_EMPTY 또는 WIA_ERROR_PAPER_PROBLEM 경우 WIA는 파일을 삭제하지 않습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wia_xp.h(Wia.h 포함)
라이브러리	Wiaguid.lib
DLL	Wiaservc.dll