IWiaTransferCallback::TransferCallback-Methode

Stellt fortschritts- 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, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Wenn diese Methode durch einen Bildverarbeitungsfilter implementiert wird, ruft der Windows Image Acquisition 2.0-Minidriver sie während der Bilderfassung auf, um Statusmeldungen zurück an die Anwendung zu senden.

Die IWiaTransferCallback::TransferCallback-Methode eines Filters muss an die IWiaTransferCallback::TransferCallback-Methode des Anwendungsrückrufs delegieren. 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