Metodo IWiaTransferCallback::GetNextStream (wia_lh.h)
Il metodo IWiaTransferCallback::GetNextStream viene implementato da un filtro di elaborazione delle immagini. Viene chiamato dal servizio WIA come risultato di un'applicazione che chiama IWiaTransfer::D ownload o il componente di anteprima IWiaPreview::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview).
Sintassi
HRESULT GetNextStream(
[in] LONG lFlags,
[in] BSTR bstrItemName,
[in] BSTR bstrFullItemName,
[out] IStream **ppDestination
);
Parametri
[in] lFlags
Riservato, impostato su zero.
[in] bstrItemName
Specifica una stringa contenente il nome dell'elemento.
[in] bstrFullItemName
Specifica una stringa contenente il nome completo dell'elemento.
[out] ppDestination
Specifica un puntatore al flusso di output.
Valore restituito
Restituisce S_OK se ha esito positivo o un valore di errore COM standard in caso contrario.
Commenti
L'implementazione del filtro di elaborazione delle immagini di IWiaTransferCallback::GetNextStream e IWiaTransferCallback::TransferCallback viene chiamata durante l'acquisizione di immagini, quando il mini-driver WIA chiede il flusso di destinazione dal client e quando il mini-driver invia messaggi di stato all'applicazione.
L'implementazione del filtro di elaborazione delle immagini di IWiaTransferCallback::GetNextStream deve delegare al metodo IWiaTransferCallback::GetNextStream dell'applicazione. Il filtro di elaborazione delle immagini usa quindi il flusso restituito dal callback dell'applicazione IWiaTransferCallback::GetNextStream per creare il proprio flusso (flusso di filtro) che passa al servizio WIA.
Nell'implementazione IWiaTransferCallback::GetNextStream , il filtro di elaborazione delle immagini deve leggere le proprietà necessarie per l'elaborazione delle immagini dall'elemento per cui viene acquisita l'immagine. Il filtro non deve leggere le proprietà direttamente dal pWiaItem2 passato in IWiaImageFilter::InitializeFilter; deve invece chiamare IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) in questo elemento WIA per ottenere l'elemento WIA effettivo. Il motivo è che durante il trasferimento di cartelle le immagini acquisite corrispondono agli elementi figlio di pWiaItem2 anziché a pWiaItem2 stesso.
Questo metodo non viene chiamato dal componente di anteprima durante IWiaPreview::UpdatePreview.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wia_lh.h (includere Wia_lh.h) |