This topic contains a list of the constants that are used for WIA IStream-based transfers.
これらの定数は、次の 3 つのサブグループに分けられます。
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 | 1 つのファイル内の複数のページをサポートする形式 (マルチファイル 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. |