Método IWiaMiniDrvCallBack::MiniDrvCallback (wiamindr_lh.h)
O método MiniDrvCallback fornece um método de retorno de chamada para os minidrivers WIA usarem durante uma transferência de dados de retorno de chamada.
Sintaxe
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 um valor constante que designa uma mensagem de status de retorno de chamada. Esse valor é usado para determinar a finalidade do retorno de chamada e pode ser um dos seguintes valores:
| Mensagem | Definição |
|---|---|
| IT_MSG_DATA | Indica que o buffer de transferência contém um bloco de dados. |
| IT_MSG_DATA_HEADER | Recebido antes de qualquer transferência de dados. Indica que o buffer de transferência aponta para uma estrutura de WIA_DATA_CALLBACK_HEADER que define elementos da transferência de dados. |
| IT_MSG_DEVICE_STATUS | O retorno de chamada contém apenas informações de status sobre o dispositivo. |
| IT_MSG_FILE_PREVIEW_DATA | Indica que os dados de visualização estão sendo transferidos para o aplicativo. |
| IT_MSG_FILE_PREVIEW_DATA_HEADER | Indica que um cabeçalho está sendo transferido para o aplicativo, antes da transferência dos dados de visualização. |
| IT_MSG_NEW_PAGE | Indica que a transferência de dados de uma página está concluída e uma nova página está sendo enviada. |
| IT_MSG_STATUS | O retorno de chamada contém apenas informações de status sobre a transferência. |
| IT_MSG_TERMINATION | Indica que a transferência de dados está concluída. |
[in] lStatus
Especifica o status da transferência. Esse parâmetro é um OR bit a bit dos seguintes valores:
| Estado | Definição |
|---|---|
| IT_STATUS_TRANSFER_FROM_DEVICE | Transferindo dados do dispositivo. |
| IT_STATUS_PROCESSING_DATA | O dispositivo e/ou o minidriver estão processando os dados. |
| IT_STATUS_TRANSFER_TO_CLIENT | Transferindo dados do minidriver para o serviço WIA. |
[in] lPercentComplete
Especifica o percentual atual de dados transferidos.
[in] lOffset
Especifica o deslocamento atual (em bytes) no buffer de transferência desde o início do buffer.
[in] lLength
Especifica o número de bytes contidos na transferência.
[in] pTranCtx
Aponta para uma estrutura MINIDRV_TRANSFER_CONTEXT que contém os valores de transferência de dados.
[in] lReserved
Reservado. Definido como zero.
Valor de retorno
Se o método for bem-sucedido, ele retornará S_OK. Se o retorno de chamada for cancelado pelo aplicativo cliente, o método retornará S_FALSE. Se o método falhar, ele retornará um código de erro COM padrão.
Observações
Os valores de porcentagem completa são enviados diretamente do driver. O serviço WIA não ajusta os valores.
IT_MSG_FILE_PREVIEW_DATA_HEADER é para dados fora da banda. Isso permite que o aplicativo que está fazendo uma transferência de arquivo exiba os dados em banda. Isso é útil para scanners alimentados com rolagem que têm um comprimento desconhecido e nenhuma verificação de visualização. As informações relatadas nesta mensagem devem ser tratadas da mesma forma que IT_MSG_DATA_HEADER. Se um driver der suporte a essa mensagem, ele poderá fornecer dados de visualização durante sua transferência de arquivo.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |