IWiaTransferCallback::TransferCallback-Methode (wia_lh.h)

Die IWiaTransferCallback::TransferCallback-Methode wird durch einen Bildverarbeitungsfilter implementiert. Sie wird vom WIA-Dienst als Ergebnis einer Anwendung aufgerufen, die IWiaTransfer::D ownload oder die IWiaPreview::GetNewPreview der Vorschaukomponente aufruft.

Syntax

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

Parameter

[in] lFlags

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

[in] pWiaTransferParams

Gibt einen Zeiger auf eine WiaTransferParams-Struktur an.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Standardfehlerwert zurück.

Hinweise

Die Implementierung der IWiaTransferCallback::TransferCallback-Methode eines Bildverarbeitungsfilters wird während der Bildaufnahme aufgerufen, wenn der WIA-Minitreiber den Zieldatenstrom vom Client anfordert und der Minitreiber Statusmeldungen zurück an die Anwendung sendet.

Die IWiaTransferCallback::TransferCallback-Methode eines Bildverarbeitungsfilters muss an die IWiaTransferCallback::TransferCallback-Methode des Anwendungsrückrufs delegieren. In vielen Fällen muss die IWiaTransferCallback::TransferCallback-Implementierung des Bildverarbeitungsfilters auch die Werte ulBytesWrittenToCurrentStream und möglicherweise auch die lPercentComplete-Werte in der WiaTransferParams-Struktur ändern. ulBytesWrittenToCurrentStream muss geändert werden, wenn der Bildverarbeitungsfilter Bilddaten zwischen Aufrufen der Write-Methode puffern muss, bevor er die Daten in den bereitgestellten Datenstrom der Anwendung schreibt. Dies wäre z. B. erforderlich, wenn das Abschleppen und/oder die Drehung durchgeführt wird. Wenn keine Drehung oder Abschleppung erforderlich ist, sollte der Filter vorzugsweise an Datenbändern arbeiten. lPercentComplete muss jedoch nicht unbedingt geändert werden, da dieser Parameter den Prozentsatz der Gesamtübertragungszeit angibt. Dieses Element kann beispielsweise von einer Statusleiste in einer Anwendung verwendet werden. Beachten Sie, dass der Bildverarbeitungsfilter das lMessage-Element der Struktur nicht ändern sollte. IWiaTransferCallback::TransferCallback sollte auch keine empfangenen Nachrichten "schlucken", auch wenn es puffert, sondern das ulBytesWrittenToCurrentStream-Element ändern.

Diese Methode wird von der Vorschaukomponente während IWiaPreview::UpdatePreview nicht aufgerufen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wia_lh.h (einschließlich Wia_lh.h)