Metodo IWiaTransferCallback::TransferCallback

Fornisce lo stato di avanzamento e altre notifiche durante un trasferimento.

Sintassi

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

Parametri

lFlags [in]

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

pWiaTransferParams [in]

Tipo: WiaTransferParams*

Specifica un puntatore a una struttura WiaTransferParams .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Quando questo metodo viene implementato da un filtro di elaborazione immagini, il minidriver windows Image Acquisition (WIA) 2.0 lo chiama durante l'acquisizione di immagini per inviare messaggi di stato all'applicazione.

Il metodo IWiaTransferCallback::TransferCallback di un filtro deve delegare al metodo IWiaTransferCallback::TransferCallback dell'applicazione. In genere, il flusso di filtro filtra i dati passati e scrive i dati filtrati direttamente nel flusso fornito dall'applicazione. Quando il filtro di elaborazione delle immagini archivia i dati tra le chiamate al metodo IStream::Write , deve anche modificare i valori lPercentComplete e ulBytesWrittenToCurrentStream nella struttura WiaTransferParams .

Requisiti