Metodo IWiaTransferCallback::TransferCallback (wia_lh.h)

Articolo
08/08/2023

Il metodo IWiaTransferCallback::TransferCallback viene implementato da un filtro di elaborazione delle immagini. Viene chiamato dal servizio WIA come risultato di un'applicazione che chiama IWiaTransfer::D ownload o il componente di anteprima IWiaPreview::GetNewPreview.

Sintassi

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

Parametri

[in] lFlags

Attualmente inutilizzato. Deve essere impostato su zero.

[in] pWiaTransferParams

Specifica un puntatore a una struttura WiaTransferParams .

Valore restituito

Restituisce S_OK se ha esito positivo o un valore di errore COM standard in caso contrario.

Commenti

L'implementazione del filtro di elaborazione delle immagini del metodo IWiaTransferCallback::TransferCallback viene chiamata durante l'acquisizione di immagini, quando il mini-driver WIA chiede il flusso di destinazione dal client e quando il mini-driver invia messaggi di stato all'applicazione.

Il metodo IWiaTransferCallback::TransferCallback di un'immagine deve delegare al metodo IWiaTransferCallback dell'applicazione. In molti casi, l'implementazione del filtro IWiaTransferCallback::TransferCallback dovrà modificare anche l'implementazione ulBytesWrittenToCurrentStream e possibilmente anche i valori lPercentComplete nella struttura WiaTransferParams. ulBytesWrittenToCurrentStream deve essere modificato se il filtro di elaborazione delle immagini deve bufferare i dati dell'immagine tra le chiamate al metodo Write prima di scrivere i dati nel flusso fornito dall'applicazione. Ciò potrebbe essere necessario, ad esempio, se viene eseguita la scrivania e/o la rotazione. Se non è necessaria alcuna rotazione o deskewing, il filtro deve preferibilmente funzionare su bande di dati. lPercentComplete non deve necessariamente essere modificato, tuttavia, poiché questo parametro indica la percentuale di tempo di trasferimento totale. Questo membro può ad esempio essere usato da una barra di stato in un'applicazione. Si noti che il filtro di elaborazione delle immagini non deve modificare il membro lMessage della struttura. IWiaTransferCallback::TransferCallback non deve anche "ingoiare" eventuali messaggi ricevuti anche se esegue il buffering, invece deve modificare il membro ulBytesWrittenToCurrentStream .

Questo metodo non viene chiamato dal componente di anteprima durante IWiaPreview::UpdatePreview.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	wia_lh.h (includere Wia_lh.h)

Condividi tramite