Metodo IWiaTransferCallback::GetNextStream (wia_lh.h)

Articolo
08/08/2023

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)

Vedi anche

IWiaImageFilter::InitializeFilter

IWiaTransferCallback

Condividi tramite