Método IWiaTransferCallback::TransferCallback (wia_lh.h)

El método IWiaTransferCallback::TransferCallback 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 IWiaPreview::GetNewPreview del componente de versión preliminar.

Sintaxis

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

Parámetros

[in] lFlags

Actualmente no se usa. Debe establecerse como cero.

[in] pWiaTransferParams

Especifica un puntero a una estructura WiaTransferParams .

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 del filtro de procesamiento de imágenes del método 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.

El método IWiaTransferCallback::TransferCallback de un filtro de procesamiento de imágenes debe delegar en el método IWiaTransferCallback::TransferCallback de la devolución de llamada de la aplicación. En muchos casos, la implementación de IWiaTransferCallback::TransferCallback del filtro de procesamiento de imágenes también tendrá que modificar ulBytesWrittenToCurrentStream y posiblemente también los valores lPercentComplete en la estructura WiaTransferParams. ulBytesWrittenToCurrentStream debe modificarse si el filtro de procesamiento de imágenes tiene que almacenar en búfer los datos de imagen entre las llamadas a su método Write antes de escribir los datos en la secuencia proporcionada por la aplicación. Esto sería, por ejemplo, necesario si se realiza la rotación y/o el escritorio. Si no se necesita ninguna rotación o rotación, el filtro debe trabajar preferiblemente en bandas de datos. lPercentComplete no tiene que modificarse necesariamente, ya que este parámetro indica el porcentaje del tiempo total de transferencia. Este miembro puede usar, por ejemplo, una barra de progreso en una aplicación. Tenga en cuenta que el filtro de procesamiento de imágenes no debe modificar el miembro lMessage de la estructura. IWiaTransferCallback::TransferCallback tampoco debe "tragar" ningún mensaje que reciba incluso si realiza el almacenamiento en búfer, en lugar de modificar el miembro ulBytesWrittenToCurrentStream .

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)