IWiaTransferCallback::GetNextStream-Methode (wia_lh.h)
Die IWiaTransferCallback::GetNextStream-Methode wird durch einen Bildverarbeitungsfilter implementiert. Sie wird vom WIA-Dienst als Ergebnis eines Anwendungsaufrufs IWiaTransfer::D ownload oder der IWiaPreview::GetNewPreview](/windows/win32/wia/wia-iwiapreview-getnewpreview) aufgerufen.
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 S_OK zurück, wenn dies erfolgreich ist, oder ein standardmäßiger COM-Fehlerwert andernfalls.
Bemerkungen
Die Implementierung eines Bildverarbeitungsfilters für IWiaTransferCallback::GetNextStream und IWiaTransferCallback::TransferCallback werden während der Imageerfassung aufgerufen, wenn der WIA-Minitreiber den Zieldatenstrom vom Client fragt und wenn der Minitreiber Statusmeldungen zurück an die Anwendung sendet.
Die Implementierung eines Bildverarbeitungsfilters für IWiaTransferCallback::GetNextStream muss an die IWiaTransferCallback::GetNextStream-Methode der Anwendung delegiert werden. Der Bildverarbeitungsfilter verwendet dann den datenstrom, der vom IWiaTransferCallback::GetNextStream Implementierung des Anwendungsrückrufs zurückgegeben wird, um einen eigenen Datenstrom (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 von dem Element benötigt werden, für das das Bild abgerufen wird. Der Filter darf die Eigenschaften nicht direkt aus dem pWiaItem2- lesen, das an IWiaImageFilter::InitializeFilterübergeben wird; stattdessen muss IWiaItem2::FindItemByName](/windows/win32/wia/-iwiaitem2-finditembyname) für dieses WIA-Element aufgerufen werden, um das tatsächliche WIA-Element abzurufen. Der Grund dafür ist, dass während einer Ordnerübertragung die abgerufenen Bilder den untergeordneten Elementen von pWiaItem2- entsprechen, anstatt PWiaItem2 selbst zu.
Diese Methode wird während IWiaPreview::UpdatePreviewnicht von der Vorschaukomponente aufgerufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wia_lh.h (einschließen Wia_lh.h) |