Metodo IWiaDataTransfer::idtGetData (wia_xp.h)

Il metodo IWiaDataTransfer::idtGetData recupera i file completi da un dispositivo Windows Image Acquisition (WIA).

Sintassi

HRESULT idtGetData(
  [in, out] LPSTGMEDIUM      pMedium,
  [in]      IWiaDataCallback *pIWiaDataCallback
);

Parametri

[in, out] pMedium

Tipo: LPSTGMEDIUM

Puntatore alla struttura STGMEDIUM .

[in] pIWiaDataCallback

Tipo: IWiaDataCallback*

Puntatore all'interfaccia IWiaDataCallback .

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno dei valori seguenti:

Questo metodo restituirà un valore specificato in Codici di errore o un errore COM standard se ha esito negativo per qualsiasi motivo diverso da quelli specificati nella tabella precedente.

Commenti

Nella maggior parte dei confronti, questo metodo funziona in modo identico al metodo IDataObject::GetData . La differenza primaria è che IWiaDataTransfer::idtGetData fornisce un parametro aggiuntivo per un puntatore all'interfaccia IWiaDataCallback . Le applicazioni usano questo parametro facoltativo per ottenere notifiche di stato durante il trasferimento dei dati. Se non sono necessarie notifiche di stato, deve essere impostata su zero.

Il formato del trasferimento dati è determinato dai valori delle proprietà di WIA_IPA_FORMAT e WIA_IPA_TYMED dell'elemento. L'applicazione imposta queste proprietà con chiamate al metodo IWiaPropertyStorage::WriteMultiple .

A differenza del metodo IWiaDataTransfer::idtGetBandedData, IWiaDataTransfer::idtGetData trasferisce un file completo da un dispositivo WIA a un'applicazione anziché solo una singola banda di dati. Il parametro pMedium è un puntatore alla struttura STGMEDIUM che contiene informazioni sul supporto di archiviazione da usare per il trasferimento dei dati. I programmi usano il parametro pIWiaDataCallback per passare questo metodo a un puntatore all'interfaccia IWiaDataCallback . Periodicamente, questo metodo userà il puntatore dell'interfaccia per richiamare il metodo BandedDataCallback e fornire all'applicazione informazioni sullo stato sul trasferimento dei dati in corso.

Passare NULL come valore del membro lpszFileName della struttura pMedium per consentire a WIA di determinare il nome e il percorso del file per il nuovo file. Al ritorno, il membro lpszFileName della struttura pMedium contiene il percorso e il nome del nuovo file.

Se il valore restituito da questo metodo è un valore COM SUCCESS o il trasferimento è un trasferimento di file a più pagine e il codice di errore restituito è WIA_ERROR_PAPER_JAM, WIA_ERROR_PAPER_EMPTY o WIA_ERROR_PAPER_PROBLEM, WIA non elimina il file.

Requisiti