IWiaTransferCallback::GetNextStream-Methode (wia_lh.h)
Die IWiaTransferCallback::GetNextStream-Methode wird durch einen Bildverarbeitungsfilter implementiert. Sie wird vom WIA-Dienst als Ergebnis einer Anwendung aufgerufen, die IWiaTransfer::D ownload oder die IWiaPreview::GetNewPreview](/windows/win32/wia/wia-iwiapreview-getnewpreview) der Vorschaukomponente aufruft.
Syntax
HRESULT GetNextStream(
[in] LONG lFlags,
[in] BSTR bstrItemName,
[in] BSTR bstrFullItemName,
[out] IStream **ppDestination
);
Parameter
[in] lFlags
Reserviert, auf Null festgelegt.
[in] bstrItemName
Gibt eine Zeichenfolge an, die den Namen des Elements enthält.
[in] bstrFullItemName
Gibt eine Zeichenfolge an, die den vollständigen Namen des Elements enthält.
[out] ppDestination
Gibt einen Zeiger auf den Ausgabedatenstrom an.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Standardfehlerwert zurück.
Hinweise
Die Implementierung von IWiaTransferCallback::GetNextStream und IWiaTransferCallback::TransferCallback eines Bildverarbeitungsfilters wird während der Bildaufnahme aufgerufen, wenn der WIA-Minitreiber vom Client nach dem Zielstream fragt und wenn der Minitreiber Statusmeldungen zurück an die Anwendung sendet.
Die Implementierung von IWiaTransferCallback::GetNextStream eines Bildverarbeitungsfilters muss an die IWiaTransferCallback::GetNextStream-Methode der Anwendung delegieren. Der Bildverarbeitungsfilter verwendet dann den Stream, der von der IWiaTransferCallback::GetNextStream-Implementierung des Anwendungsrückrufs zurückgegeben wird, um einen eigenen Stream (den "Filterdatenstrom") zu erstellen, den er an den WIA-Dienst zurückgibt.
In seiner IWiaTransferCallback::GetNextStream-Implementierung sollte der Bildverarbeitungsfilter lesen, welche Eigenschaften für die Bildverarbeitung aus dem Element, für das das Image abgerufen wird, benötigt werden. Der Filter darf die Eigenschaften nicht direkt aus dem an IWiaImageFilter::InitializeFilter übergebenen pWiaItem2 lesen. Stattdessen muss IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) für dieses WIA-Element aufgerufen werden, um das tatsächliche WIA-Element abzurufen. Der Grund ist, dass die während einer Ordnerübertragung erfassten Bilder den untergeordneten Elementen von pWiaItem2 und nicht pWiaItem2 selbst entsprechen.
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) |