Método IWiaMiniDrvCallBack::MiniDrvCallback (wiamindr_lh.h)
El método MiniDrvCallback proporciona un método de devolución de llamada para que los minidrivers WIA se usen durante una transferencia de datos de devolución de llamada.
Sintaxis
HRESULT MiniDrvCallback(
[in] LONG lReason,
[in] LONG lStatus,
[in] LONG lPercentComplete,
[in] LONG lOffset,
[in] LONG lLength,
[in] PMINIDRV_TRANSFER_CONTEXT pTranCtx,
[in] LONG lReserved
);
Parámetros
[in] lReason
Especifica un valor constante que designa un mensaje de estado de devolución de llamada. Este valor se usa para determinar el propósito de la devolución de llamada y puede ser uno de los siguientes valores:
| Mensaje | Definición |
|---|---|
| IT_MSG_DATA | Indica que el búfer de transferencia contiene un bloque de datos. |
| IT_MSG_DATA_HEADER | Recibido antes de las transferencias de datos. Indica que el búfer de transferencia apunta a una estructura de WIA_DATA_CALLBACK_HEADER que define los elementos de la transferencia de datos. |
| IT_MSG_DEVICE_STATUS | La devolución de llamada solo contiene información de estado sobre el dispositivo. |
| IT_MSG_FILE_PREVIEW_DATA | Indica que los datos de vista previa se transfieren a la aplicación. |
| IT_MSG_FILE_PREVIEW_DATA_HEADER | Indica que se transfiere un encabezado a la aplicación, antes de transferir los datos de vista previa. |
| IT_MSG_NEW_PAGE | Indica que la transferencia de datos de una página está completa y se envía una nueva página. |
| IT_MSG_STATUS | La devolución de llamada solo contiene información de estado sobre la transferencia. |
| IT_MSG_TERMINATION | Indica que se ha completado la transferencia de datos. |
[in] lStatus
Especifica el estado de la transferencia. Este parámetro es un OR bit a bit de los siguientes valores:
| Estado | Definición |
|---|---|
| IT_STATUS_TRANSFER_FROM_DEVICE | Transferencia de datos desde el dispositivo. |
| IT_STATUS_PROCESSING_DATA | El dispositivo o el minidriver están procesando los datos. |
| IT_STATUS_TRANSFER_TO_CLIENT | Transferencia de datos desde el minidriver al servicio WIA. |
[in] lPercentComplete
Especifica el porcentaje actual de datos transferidos.
[in] lOffset
Especifica el desplazamiento actual (en bytes) en el búfer de transferencia desde el principio del búfer.
[in] lLength
Especifica el número de bytes contenidos en la transferencia.
[in] pTranCtx
Apunta a una estructura de MINIDRV_TRANSFER_CONTEXT que contiene los valores de transferencia de datos.
[in] lReserved
Reservado. Establecer en cero.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si la aplicación cliente cancela la devolución de llamada, el método devuelve S_FALSE. Si se produce un error en el método, devuelve un código de error COM estándar.
Comentarios
Los valores completos de porcentaje se envían directamente desde el controlador. El servicio WIA no ajusta los valores.
IT_MSG_FILE_PREVIEW_DATA_HEADER es para datos fuera de banda. Esto permite que la aplicación realice una transferencia de archivos para mostrar los datos agrupados. Esto es útil para los escáneres alimentados por desplazamiento que tienen una longitud desconocida y ningún examen de vista previa. La información notificada en este mensaje debe tratarse igual que IT_MSG_DATA_HEADER. Si un controlador admite este mensaje, puede proporcionar datos de vista previa durante su transferencia de archivos.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiamindr_lh.h (incluya Wiamindr.h) |