IWiaTransferCallback::TransferCallback-Methode

Stellt den Fortschritt und andere Benachrichtigungen während einer Übertragung bereit.

Syntax

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

Parameter

lFlags [ In]

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

pWiaTransferParams [ In]

Typ: WiaTransferParams*

Gibt einen Zeiger auf eine WiaTransferParams-Struktur an.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn diese Methode von einem Bildverarbeitungsfilter implementiert wird, ruft der minidriver Windows Image Acquisition (WIA) 2.0 diese während der Imageerfassung auf, um Statusmeldungen an die Anwendung zurückzusenden.

Die IWiaTransferCallback::TransferCallback eines Filters muss an die IWiaTransferCallback::TransferCallback-Methode des Anwendungsrückrufs delegiert werden. In der Regel filtert der Filterstream die an ihn übergebenen Daten und schreibt die gefilterten Daten direkt in den von der Anwendung bereitgestellten Stream. Wenn der Bildverarbeitungsfilter Daten zwischen Aufrufen der IStream::Write-Methode speichert, muss er auch die Werte lPercentComplete und ulBytesWrittenToCurrentStream in der WiaTransferParams-Struktur ändern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
Wia.h
Idl
Wia.idl
Bibliothek
Wiaguid.lib