WIA 전송 상수

아티클
08/08/2022
읽는 데 4분 걸림

이 항목에는 WIA IStream 기반 전송에 사용되는 상수 목록이 포함되어 있습니다.

이러한 상수는 세 개의 하위 그룹으로 나뉩니다.

항목 유형
콜백 메시지
전송 플래그

Item Type

다음 표에서는 스트림 기반 데이터 전송과 관련된 WIA 항목 유형 비트를 보여 줍니다.

Name	Description
WiaItemTypeTransfer	이 WIA_IPA_ITEM_FLAGS 비트는 데이터를 전송할 수 있는 모든 항목에 설정해야 합니다. 즉, 애플리케이션은 이 비트가 설정된 항목에 대한 다운로드 또는 업로드를 시작할 수 있습니다.

콜백 메시지

다음 표에서는 IWiaTransferCallback::TransferCallback의 lFlags 매개 변수에 사용할 수 있는 값을 보여 줍니다.

Name	Description
WIA_TRANSFER_MSG_STATUS	애플리케이션에 전송 진행률을 알 수 있습니다. pWiaTransferParams-lPercentComplete>에는 이 항목의 완료율과 전송되는 페이지가 포함됩니다.
WIA_TRANSFER_MSG_END_OF_STREAM	애플리케이션에 현재 데이터 스트림으로 전송할 데이터가 더 이상 없으며 스트림이 닫혀 있을 수 있음을 알 수 있습니다. 이후 다중 항목 또는 다중 페이지 전송에서 새 스트림을 요청할 수 있습니다. 드라이버는 이 메시지를 수동으로 보내지 않습니다. 드라이버가 다음 스트림을 요청하면 WIA 서비스가 이 메시지를 자동으로 보냅니다.
WIA_TRANSFER_MSG_END_OF_TRANSFER	전송이 끝날 때 애플리케이션에서 수신합니다. 드라이버는 이 메시지를 보내지 않습니다. WIA 서비스는 전송이 종료된 후 자동으로 이 메시지를 보냅니다(즉, IWiaMiniDrv::d rvAcquiItemData 가 반환됨).
WIA_TRANSFER_MSG_ERROR	나중에 사용하기 위해 Microsoft에서 예약합니다.
WIA_TRANSFER_MSG_DEVICE_STATUS	전송 중에 발생하는 오류(예: 용지 걸림)를 나타냅니다. pWiaTransferParams-hrErrorStatus>에는 오류 상태 코드가 포함되어 있습니다.
WIA_TRANSFER_MSG_NEW_PAGE	한 파일의 여러 페이지(예: 다중 파일 TIFF)를 지원하는 형식이 사용될 때 다중 페이지 전송 중에 새 페이지가 전송되고 있음을 나타냅니다.

전송 플래그

다음 표에서는 IWiaMiniDrv::d rvAcquireItemData로 전달될 수 있는 플래그를 보여줍니다.

Name	Description
WIA_MINIDRV_TRANSFER_DOWNLOAD	전송이 스트림 기반 다운로드 작업(즉, 디바이스에서 애플리케이션으로의 데이터 전송)임을 나타냅니다. 애플리케이션은 이 비트를 직접 설정하지 않습니다. 애플리케이션이 IWiaTransfer::D ownload를 호출하는 경우 WIA 서비스는 이 비트를 설정합니다.
WIA_MINIDRV_TRANSFER_UPLOAD	전송이 스트림 기반 업로드 작업(즉, 애플리케이션에서 디바이스로의 데이터 전송)임을 나타냅니다. 애플리케이션은 이 비트를 직접 설정하지 않습니다. 애플리케이션이 IWiaTransfer::업로드 호출하는 경우 WIA 서비스는 이 비트를 설정합니다.
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN	드라이버가 폴더 전송을 수행해야 임을 나타냅니다. 폴더 항목에서 이 값을 호출하면 애플리케이션에서 해당 폴더의 자식을 전송하도록 요청합니다. 이 값은 애플리케이션이 IWiaTransfer::D ownload의 lFlags 매개 변수를 WIA _TRANSFER_ACQUIRE_CHILDREN 설정하여 폴더 전송을 요청하고 드라이버가 한 번의 검사에서 여러 자식을 전송 할 수 있도록 지정한 경우 설정됩니다. 드라이버가 이러한 유형의 전송을 수행할 수 없는 경우 WIA 서비스는 드라이버에 여러 번의 호출을 수행하며 WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN 설정 되지 않습니다 .

WIA_MINIDRV_TRANSFER_DOWNLOAD

전송이 스트림 기반 다운로드 작업(즉, 디바이스에서 애플리케이션으로의 데이터 전송)임을 나타냅니다.

애플리케이션은 이 비트를 직접 설정하지 않습니다. 애플리케이션이 IWiaTransfer::D ownload를 호출하는 경우 WIA 서비스는 이 비트를 설정합니다.

WIA_MINIDRV_TRANSFER_UPLOAD

전송이 스트림 기반 업로드 작업(즉, 애플리케이션에서 디바이스로의 데이터 전송)임을 나타냅니다.

애플리케이션은 이 비트를 직접 설정하지 않습니다. 애플리케이션이 IWiaTransfer::업로드 호출하는 경우 WIA 서비스는 이 비트를 설정합니다.

WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN

드라이버가 폴더 전송을 수행해야 임을 나타냅니다. 폴더 항목에서 이 값을 호출하면 애플리케이션에서 해당 폴더의 자식을 전송하도록 요청합니다.

이 값은 애플리케이션이 IWiaTransfer::D ownload의 lFlags 매개 변수를 WIA _TRANSFER_ACQUIRE_CHILDREN 설정하여 폴더 전송을 요청하고 드라이버가 한 번의 검사에서 여러 자식을 전송 할 수 있도록 지정한 경우 설정됩니다. 드라이버가 이러한 유형의 전송을 수행할 수 없는 경우 WIA 서비스는 드라이버에 여러 번의 호출을 수행하며 WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN 설정 되지 않습니다 .

IWiaTransfer 및 IWiaTransferCallback 인터페이스에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.