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 in caso di esito positivo o un valore di errore COM standard in caso contrario.
Osservazioni
L'implementazione del filtro di elaborazione delle immagini di IWiaTransferCallback::GetNextStream e IWiaTransferCallback::TransferCallback vengono chiamate durante l'acquisizione dell'immagine, quando il mini-driver WIA richiede 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. Il filtro di elaborazione delle immagini usa quindi il flusso restituito dal callback dell'applicazione IWiaTransferCallback::GetNextStream implementazione per creare il proprio flusso (il "flusso di filtro") restituito al servizio WIA.
Nell'implementazione IWiaTransferCallback::GetNextStream, il filtro di elaborazione delle immagini deve leggere le proprietà necessarie per l'elaborazione dell'immagine 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) su questo elemento WIA per ottenere l'elemento WIA effettivo. Il motivo è che durante un trasferimento di cartelle le immagini acquisite corrispondono agli elementi figlio di pWiaItem2 anziché a pWiaItem2 stessa.
Questo metodo non viene chiamato dal componente di anteprima durante IWiaPreview::UpdatePreview.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wia_lh.h (includere Wia_lh.h) |