Costanti di trasferimento WIA

Questo argomento contiene un elenco delle costanti utilizzate per i trasferimenti basati su WIA IStream.

Queste costanti sono suddivise in tre sottogruppi:

Tipo di elemento

La tabella seguente illustra i bit del tipo di elemento WIA correlati al trasferimento dei dati basato su flusso.

Nome	Descrizione
WiaItemTypeTransfer	Questo WIA_IPA_ITEM_FLAGS bit deve essere impostato su tutti gli elementi in grado di trasferire i dati; ovvero, un'applicazione può avviare un download o un caricamento su elementi con questo bit impostato.

La tabella seguente mostra i valori possibili per il parametro lFlags di IWiaTransferCallback::TransferCallback.

Nome	Descrizione
WIA_TRANSFER_MSG_STATUS	Notifica all'applicazione lo stato di avanzamento del trasferimento. pWiaTransferParams-lPercentComplete> contiene la percentuale di completamento per questo elemento e la pagina da trasferire.
WIA_TRANSFER_MSG_END_OF_STREAM	Notifica all'applicazione che non sono presenti altri dati da trasferire nel flusso di dati corrente e che il flusso può essere chiuso. Un nuovo flusso può successivamente essere richiesto in un trasferimento a più elementi o a più pagine. I driver non inviano questo messaggio manualmente. Il servizio WIA invierà automaticamente questo messaggio quando il driver chiede il flusso successivo.
WIA_TRANSFER_MSG_END_OF_TRANSFER	Ricevuto dall'applicazione alla fine del trasferimento. Il driver non invia questo messaggio. Il servizio WIA invierà automaticamente questo messaggio al termine del trasferimento, ovvero la chiamata a IWiaMiniDrv::d rvAcquireItemData restituisce.
WIA_TRANSFER_MSG_ERROR	Riservato da Microsoft per un uso futuro.
WIA_TRANSFER_MSG_DEVICE_STATUS	Indica un errore durante il trasferimento (ad esempio, una marmellata di carta). pWiaTransferParams-hrErrorStatus> contiene il codice di stato dell'errore.
WIA_TRANSFER_MSG_NEW_PAGE	Indica che viene trasferita una nuova pagina durante un trasferimento a più pagine quando viene utilizzato un formato che supporta più pagine in un file,ad esempio tiFF multifile.

La tabella seguente illustra i flag che possono essere passati a IWiaMiniDrv::d rvAcquireItemData.

Nome	Descrizione
WIA_MINIDRV_TRANSFER_DOWNLOAD	Indica che il trasferimento è un'operazione di download basata su flusso, ovvero un trasferimento di dati da un dispositivo a un'applicazione. Le applicazioni non impostano questo bit direttamente. Il servizio WIA imposta questo bit se l'applicazione chiama IWiaTransfer::D ownload.
WIA_MINIDRV_TRANSFER_UPLOAD	Indica che il trasferimento è un'operazione di caricamento basata su flusso, ovvero un trasferimento di dati da un'applicazione a un dispositivo. Le applicazioni non impostano questo bit direttamente. Il servizio WIA imposta questo bit se l'applicazione chiama IWiaTransfer::Upload.
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN	Indica che il driver deve eseguire un trasferimento di cartelle. Se questo valore viene chiamato su un elemento della cartella, l'applicazione richiede di trasferire gli elementi figlio di tale cartella. Questo valore verrà impostato se un'applicazione richiede un trasferimento di cartelle impostando il parametro lFlags di IWiaTransfer::D ownload su WIA_TRANSFER_ACQUIRE_CHILDREN e il driver ha specificato che può trasferire più elementi figlio in un'unica analisi. Se il driver non può eseguire questo tipo di trasferimento, il servizio WIA effettuerà più chiamate al driver e WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN non verrà impostato.