Constantes de transferencia wia

Este tema contiene una lista de las constantes que se usan para las transferencias basadas en IStream de WIA.

Estas constantes se dividen en tres subgrupos:

Tipo de elemento

En la tabla siguiente se muestran los bits de tipo de elemento WIA relacionados con la transferencia de datos basada en secuencias.

Nombre	Descripción
WiaItemTypeTransfer	Este bit de WIA_IPA_ITEM_FLAGS debe establecerse en todos los elementos que sean capaces de transferir datos; es decir, una aplicación puede iniciar una descarga o carga en los elementos que tienen este conjunto de bits.

En la tabla siguiente se muestran los valores posibles para el parámetro lFlags de IWiaTransferCallback::TransferCallback.

Nombre	Descripción
WIA_TRANSFER_MSG_STATUS	Notifica a la aplicación del progreso de la transferencia. pWiaTransferParams-lPercentComplete> contiene el porcentaje completado para este elemento y la página que se va a transferir.
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 páginas múltiples. 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. El servicio WIA enviará este mensaje automáticamente una vez finalizada la transferencia (es decir, la llamada a IWiaMiniDrv::d rvAcquireItemData devuelve).
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> contiene el código de estado de error.
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).

En la tabla siguiente se muestran las marcas que se pueden pasar a IWiaMiniDrv::d rvAcquireItemData.

Nombre	Descripción
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. El servicio WIA establece este bit si la aplicación llama a IWiaTransfer::D ownload.
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. El servicio WIA establece este bit si la aplicación llama a 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. Este valor se establecerá si una aplicación solicita una transferencia de carpetas estableciendo el parámetro lFlags de IWiaTransfer::D ownload en WIA_TRANSFER_ACQUIRE_CHILDREN y el controlador ha especificado que puede transferir varios elementos secundarios en un examen. Si el controlador no puede realizar este tipo de transferencia, el servicio WIA realizará varias llamadas al controlador y no se establecerá WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN.