Método IWiaTransferCallback::GetNextStream (wia_lh.h)
O método IWiaTransferCallback::GetNextStream é implementado por um filtro de processamento de imagem. Ele é chamado pelo serviço WIA como resultado de um aplicativo que chama IWiaTransfer::D ownload ou IWiaPreview::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview).
Sintaxe
HRESULT GetNextStream(
[in] LONG lFlags,
[in] BSTR bstrItemName,
[in] BSTR bstrFullItemName,
[out] IStream **ppDestination
);
Parâmetros
[in] lFlags
Reservado, definido como zero.
[in] bstrItemName
Especifica uma cadeia de caracteres que contém o nome do item.
[in] bstrFullItemName
Especifica uma cadeia de caracteres que contém o nome completo do item.
[out] ppDestination
Especifica um ponteiro para o fluxo de saída.
Retornar valor
Retorna S_OK se tiver êxito ou um valor de erro COM padrão, caso contrário.
Comentários
A implementação de um filtro de processamento de imagem de IWiaTransferCallback::GetNextStream e IWiaTransferCallback::TransferCallback é chamada durante a aquisição da imagem, quando o mini driver WIA solicita o fluxo de destino do cliente e quando o mini driver envia mensagens de progresso de volta para o aplicativo.
A implementação de um filtro de processamento de imagem do método IWiaTransferCallback::GetNextStream deve delegar ao método IWiaTransferCallback::GetNextStream do aplicativo. Em seguida, o filtro de processamento de imagem usa o fluxo retornado pela implementação IWiaTransferCallback::GetNextStream do aplicativo para criar seu próprio fluxo (o "fluxo de filtragem") que ele passa de volta para o serviço WIA.
Em sua implementação IWiaTransferCallback::GetNextStream , o filtro de processamento de imagem deve ler quais propriedades são necessárias para o processamento de imagem do item para o qual a imagem está sendo adquirida. O filtro não deve ler as propriedades diretamente do pWiaItem2 passado para IWiaImageFilter::InitializeFilter; em vez disso, ele deve chamar IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) neste item WIA para obter o item WIA real. O motivo é que, durante uma transferência de pasta, as imagens adquiridas correspondem aos itens filho do pWiaItem2 em vez do próprio pWiaItem2 .
Esse método não é chamado pelo componente de visualização durante IWiaPreview::UpdatePreview.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wia_lh.h (inclua Wia_lh.h) |