Método IWiaTransferCallback::GetNextStream (wia_lh.h)
El método IWiaTransferCallback::GetNextStream se implementa mediante un filtro de procesamiento de imágenes. El servicio WIA lo llama como resultado de una aplicación que llama a IWiaTransfer::D ownload o la IWiaPreview::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview).
Sintaxis
HRESULT GetNextStream(
[in] LONG lFlags,
[in] BSTR bstrItemName,
[in] BSTR bstrFullItemName,
[out] IStream **ppDestination
);
Parámetros
[in] lFlags
Reservado, establecido en cero.
[in] bstrItemName
Especifica una cadena que contiene el nombre del elemento.
[in] bstrFullItemName
Especifica una cadena que contiene el nombre completo del elemento.
[out] ppDestination
Especifica un puntero al flujo de salida.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente o un valor de error COM estándar de lo contrario.
Comentarios
Se llama a la implementación de un filtro de procesamiento de imágenes de IWiaTransferCallback::GetNextStream e IWiaTransferCallback::TransferCallback durante la adquisición de imágenes, cuando el mini-controlador WIA solicita la secuencia de destino del cliente y cuando el mini-driver envía mensajes de progreso de nuevo a la aplicación.
La implementación de un filtro de procesamiento de imágenes de IWiaTransferCallback::GetNextStream debe delegar en el método IWiaTransferCallback::GetNextStream de la aplicación. A continuación, el filtro de procesamiento de imágenes usa la secuencia devuelta por la implementación IWiaTransferCallback::GetNextStream de la devolución de llamada de la aplicación para crear su propia secuencia (la "secuencia de filtrado") que pasa al servicio WIA.
En su implementación de IWiaTransferCallback::GetNextStream , el filtro de procesamiento de imágenes debe leer qué propiedades son necesarias para su procesamiento de imágenes del elemento para el que se adquiere la imagen. El filtro no debe leer las propiedades directamente de pWiaItem2 pasadas a IWiaImageFilter::InitializeFilter; sino que debe llamar a IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) en este elemento WIA para obtener el elemento WIA real. El motivo es que, durante una transferencia de carpetas, las imágenes adquiridas corresponden a los elementos secundarios de pWiaItem2 en lugar de a pWiaItem2 .
El componente de vista previa no llama a este método durante IWiaPreview::UpdatePreview.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | wia_lh.h (incluya Wia_lh.h) |