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

IWiaDataTransfer::idtGetBandedData 메서드는 하드웨어 디바이스에서 애플리케이션으로 데이터 대역을 전송합니다. 효율성을 위해 애플리케이션은 연속 대역의 WIA(Windows Image Acquisition) 하드웨어 디바이스에서 데이터를 검색합니다.

구문

HRESULT idtGetBandedData(
  [in] PWIA_DATA_TRANSFER_INFO pWiaDataTransInfo,
  [in] IWiaDataCallback        *pIWiaDataCallback
);

매개 변수

[in] pWiaDataTransInfo

형식: PWIA_DATA_TRANSFER_INFO

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

[in] pIWiaDataCallback

형식: IWiaDataCallback*

IWiaDataCallback 인터페이스에 대한 포인터입니다. 주기적으로 이 메서드는 BandedDataCallback 메서드를 호출하여 애플리케이션에 데이터 전송 상태 알림을 제공합니다.

반환 값

형식: HRESULT

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

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

설명

IWiaDataTransfer::idtGetBandedData 메서드는 구성 요소 개체 모델/원격 프로시저 호출(COM/RPC) 마샬링 계층을 통해 추가 데이터 복사를 요구하지 않고도 데이터를 전송하기 위해 메모리 섹션을 할당합니다. 이 메모리 섹션은 애플리케이션과 하드웨어 디바이스의 항목 트리 간에 공유됩니다.

필요에 따라 애플리케이션은 IWiaDataTransfer::idtGetBandedData 가 공유 섹션으로 사용할 메모리 블록에 대한 포인터를 전달할 수 있습니다. 애플리케이션은 IWiaDataTransfer::idtGetBandedData를 호출하기 전에 WIA_DATA_TRANSFER_INFO 구조체의 ulSection 멤버에 포인터를 저장하여 이 핸들을 전달합니다.

애플리케이션은 이중 버퍼링을 사용하여 성능을 향상시킬 수 있습니다. 이렇게 하려면 애플리케이션에서 WIA_DATA_TRANSFER_INFO 구조체의 bDoubleBuffer 멤버를 TRUE로 설정해야 합니다. IWiaDataTransfer::idtGetBandedData 메서드는 데이터 버퍼를 반으로 나눕니다. 버퍼의 절반이 가득 차면 IWiaDataTransfer::idtGetBandedData는 pIWiaDataCallback 매개 변수를 통해 전달된 IWiaDataCallback 포인터를 사용하여 애플리케이션에 알림을 보냅니다. 애플리케이션이 버퍼의 전체 절반에서 데이터를 검색하는 동안 디바이스 드라이버는 나머지 절반을 데이터로 채울 수 있습니다.

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

요구 사항