Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
This topic contains a list of the constants that are used for WIA IStream-based transfers.
Estas constantes se dividen en tres subgrupos:
Item type
Callback messages
Transfer flags
Item type
En la tabla siguiente se muestra qué bits de tipo de elemento WIA se relacionan con la transferencia de datos basada en secuencias.
| 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 | Notifica a la aplicación del progreso de la transferencia. pWiaTransferParams->lPercentComplete contains the percent complete for this item and the page that is being transferred. |
| WIA_TRANSFER_MSG_END_OF_STREAM | Notifica a la aplicación que no hay más datos que se van a transferir al flujo de datos actual y que se puede cerrar la secuencia. Posteriormente, se puede solicitar una nueva secuencia en una transferencia de varios elementos o de varias páginas. Los controladores no envían este mensaje manualmente. El servicio WIA enviará automáticamente este mensaje cuando el controlador solicite la siguiente secuencia. |
| WIA_TRANSFER_MSG_END_OF_TRANSFER | Recibido por la aplicación al final de la transferencia. El controlador no envía este mensaje. 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 | Reservado por Microsoft para su uso futuro. |
| WIA_TRANSFER_MSG_DEVICE_STATUS | Indica un error durante la transferencia (por ejemplo, un atasco de papel). pWiaTransferParams->hrErrorStatus contains the error status code. |
| WIA_TRANSFER_MSG_NEW_PAGE | Indica que se transfiere una nueva página durante una transferencia de varias páginas cuando se usa un formato que admite varias páginas en un archivo (como TIFF de varios archivos). |
Transfer flags
The following table shows the flags that may be passed into IWiaMiniDrv::drvAcquireItemData.
| Name | Description |
|---|---|
| WIA_MINIDRV_TRANSFER_DOWNLOAD | Indica que la transferencia es una operación de descarga basada en secuencias (es decir, una transferencia de datos de un dispositivo a una aplicación). Las aplicaciones no establecen este bit directamente. The WIA service sets this bit if the application calls IWiaTransfer::Download. |
| WIA_MINIDRV_TRANSFER_UPLOAD | Indica que la transferencia es una operación de carga basada en secuencias (es decir, una transferencia de datos de una aplicación a un dispositivo). Las aplicaciones no establecen este bit directamente. The WIA service sets this bit if the application calls IWiaTransfer::Upload. |
| WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN | Indica que el controlador debe realizar una transferencia de carpetas. Si se llama a este valor en un elemento de carpeta, la aplicación solicita transferir los elementos secundarios de esa carpeta. 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. |