Contextos de transferência
Um contexto de transferência é uma coleção de informações que descreve uma transferência de dados do minidriver para um aplicativo. As informações sobre a transferência são armazenadas em uma estrutura MINIDRV_TRANSFER_CONTEXT . Um contexto de transferência inclui membros que contêm informações sobre a imagem que deve ser transferida: seu tamanho, resolução, profundidade de cor (número de bytes por pixel), tipo de compactação e formato de imagem. O serviço WIA obtém esses valores das propriedades relevantes do item WIA antes de chamar o método IWiaMiniDrv::d rvAcquireItemData . Em seguida, os valores são armazenados em uma estrutura MINIDRV_TRANSFER_CONTEXT e entregues ao driver para acesso conveniente. Esse processo elimina a necessidade de o driver usar as rotinas da biblioteca de serviços WIA para ler esses valores do contexto do item de aplicativo (ou seja, o contexto do serviço WIA).
Um contexto de transferência também inclui informações sobre o tipo de transferência: se é uma transferência de dados de arquivo ou uma transferência de retorno de chamada de memória. Para transferências de dados de arquivo, um membro contém um identificador para o arquivo que será gravado. É recomendável que os minidrivers não toquem nessa alça. O serviço WIA abre o identificador antes que a transferência ocorra e o fecha após a conclusão da transferência. Para transferências de dados de retorno de chamada de memória (e para transferências de dados de arquivo em que o aplicativo deve receber atualizações do minidriver), um membro contém o endereço da rotina de retorno de chamada do minidriver.
Outros membros contêm informações como o tamanho total de todos os buffers usados na transferência e se o minidriver ou o serviço WIA os alocaram. Consulte MINIDRV_TRANSFER_CONTEXT para obter uma lista completa dos membros dessa estrutura.
O minidriver, juntamente com a função wiasGetImageInformation , define muitos dos itens de contexto de transferência que descrevem a própria imagem, como sua largura em pixels e o número de linhas. O serviço WIA define muitos dos itens de contexto de transferência que se preocupam com a transferência de dados, como o identificador de arquivo (quando aplicável), o tipo de transferência.