다음을 통해 공유


WIA 전송 상수

This topic contains a list of the constants that are used for WIA IStream-based transfers.

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

  • Item type

  • Callback messages

  • Transfer flags

Item type

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

Name Description
WiaItemTypeTransfer This WIA_IPA_ITEM_FLAGS bit should be set on all items that are capable of transferring data; that is, an application can initiate a download or upload on items that have this bit set.

Callback messages

The following table shows possible values for the lFlags parameter of IWiaTransferCallback::TransferCallback.

Name Description
WIA_TRANSFER_MSG_STATUS 애플리케이션에 전송 진행률을 알 수 있습니다.

pWiaTransferParams->lPercentComplete contains the percent complete for this item and the page that is being transferred.
WIA_TRANSFER_MSG_END_OF_STREAM 애플리케이션에 현재 데이터 스트림으로 전송할 데이터가 더 이상 없으며 스트림이 닫혀 있을 수 있음을 알 수 있습니다.

이후 다중 항목 또는 다중 페이지 전송에서 새 스트림을 요청할 수 있습니다.

드라이버는 이 메시지를 수동으로 보내지 않습니다. WIA 서비스는 드라이버가 다음 스트림을 요청할 때 이 메시지를 자동으로 보냅니다.
WIA_TRANSFER_MSG_END_OF_TRANSFER 전송이 끝날 때 애플리케이션에서 수신합니다.

드라이버에서 이 메시지를 보내지 않습니다. The WIA service will send this message automatically after the transfer has ended (that is, the call to IWiaMiniDrv::drvAcquireItemData returns).
WIA_TRANSFER_MSG_ERROR 나중에 사용하기 위해 Microsoft에서 예약합니다.
WIA_TRANSFER_MSG_DEVICE_STATUS 전송 중 오류를 나타냅니다(예: 용지 걸림).

pWiaTransferParams->hrErrorStatus contains the error status code.
WIA_TRANSFER_MSG_NEW_PAGE 한 파일의 여러 페이지(예: 다중 파일 TIFF)를 지원하는 형식이 사용될 때 다중 페이지 전송 중에 새 페이지가 전송되고 있음을 나타냅니다.

Transfer flags

The following table shows the flags that may be passed into IWiaMiniDrv::drvAcquireItemData.

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

애플리케이션은 이 비트를 직접 설정하지 않습니다. The WIA service sets this bit if the application calls IWiaTransfer::Download.
WIA_MINIDRV_TRANSFER_UPLOAD 전송이 스트림 기반 업로드 작업(즉, 애플리케이션에서 디바이스로의 데이터 전송)임을 나타냅니다.

애플리케이션은 이 비트를 직접 설정하지 않습니다. The WIA service sets this bit if the application calls IWiaTransfer::Upload.
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN 드라이버가 폴더 전송을 수행해야 임을 나타냅니다. 이 값이 폴더 항목에서 호출되면 애플리케이션은 해당 폴더의 자식을 전송하도록 요청합니다.

This value will be set if an application requests a folder transfer by setting the lFlags parameter of IWiaTransfer::Download to WIA_TRANSFER_ACQUIRE_CHILDREN and the driver has specified that it can transfer multiple children in one scan. If the driver cannot perform this type of transfer, the WIA service will make multiple calls into the driver and WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN will not be set.