Comandos necessários

O seguinte conjunto de comandos necessários deve ser implementado por cada microdriver.

CMD_GETCAPABILITIES

Chamado pelo driver WIA Flatbed para obter informações de evento de botão. Três membros da estrutura VAL passada devem ser preenchidos: lVal deve ser definido como o número de botões; pGuid deve ser definido como uma matriz de GUIDs de evento; ppButtonNames pode ser opcionalmente definido como uma matriz WCHAR* que contém os nomes dos botões na mesma ordem em que estão no pGuid (por exemplo, "Botão Digitalizar" ou "Botão Fax"). Se ppButtonNames estiver definido como NULL, o Driver Flatbed wia criará nomes de botão genéricos. As matrizes podem ser alocadas em resposta a CMD_INITIALIZE e liberadas em CMD_UNINITIALIZE.

CMD_INITIALIZE

Chamado pelo Driver de Flatbed WIA para inicializar o microdriver e definir identificadores de E/S do dispositivo com valores válidos. Esse comando será enviado ao microdriver quando o serviço WIA chamar o método IWiaMiniDrv::drvInitializeWia no Driver de Scanner Planar WIA.

O Driver Flatbed WIA criará automaticamente um identificador de E/S de dispositivo e o colocará no membro da matriz DeviceIOHandles da estrutura SCANINFO passada no índice 0. O microdriver deve usar esse identificador quando precisar se comunicar com o dispositivo. Se o microdriver precisar de identificadores de dispositivo adicionais (por exemplo, para usar várias vias USB em massa), eles poderão ser criados e armazenados na matriz DeviceIOHandles até um número máximo de MAX_IO_HANDLES. O Driver WIA Flatbed fechará automaticamente o identificador na posição 0, porque ele criou esse identificador durante a inicialização. Os outros manipuladores devem ser fechados pelo microdriver em resposta a CMD_UNINITIALIZE.

Como parte desse comando, o microdriver também deve inicializar todos os valores na estrutura SCANINFO . O microdriver deve definir os membros SupportedDataTypes, IntensityRange, ContrastRange, BedWidth e BedHeight da estrutura SCANINFO, de modo que o Driver Flatbed WIA possa validar automaticamente esses valores nos intervalos legais do dispositivo.

CMD_RESETSCANNER

Chamado pelo Driver WIA Flatbed para reinicializar o dispositivo em resposta a um pedido de serviço WIA. O microdriver deve definir o dispositivo para o estado ligado. No Windows Vista, o Driver flatbed wia não usa esse comando. No entanto, os microdrivers devem continuar a dar suporte a esse comando para garantir a operação correta no Windows XP e, possivelmente, com uma versão futura do driver WIA Flatbed que pode usar esse comando.

CMD_SETDATATYPE

Chamado pelo driver WIA de mesa plana para definir o tipo de dados para a digitalização. Um dos seguintes valores é passado no membro lVal da estrutura val passada:

• WIA_DATA_THRESHOLD – 1 bit preto/branco

• WIA_DATA_GRAYSCALE − escala de cinza de 8 bits

• WIA_DATA_COLOR – cor de 24 bits

O microdriver deve armazenar o valor no membro DataType da estrutura SCANINFO passada.

CMD_SETCONTRAST

Chamado pelo WIA Flatbed Driver para ajustar o valor de contraste para a digitalização. O valor de contraste desejado é passado no membro lVal da estrutura val passada. O valor <1000 deve ser interpretado como o menor valor de contraste, 0 nominal e 1000 o contraste máximo do dispositivo. O microdriver deve armazenar o valor no membro Contrast da estrutura SCANINFO passada.

CMD_SETINTENSITY

Chamado pelo driver de flatbed WIA para definir o valor de intensidade ou brilho para a digitalização. O valor de intensidade desejado é passado no membro lVal da estrutura val passada. O valor <1000 deve ser interpretado como o menor valor de brilho, 0 nominal e 1000 o brilho máximo do dispositivo. O microdriver deve armazenar o valor no membro Intensity da estrutura SCANINFO passada.

CMD_SETXRESOLUTION

Chamado pelo Driver Flatbed WIA para definir a resolução de digitalização horizontal. A resolução desejada em pixels é passada no membro lVal da estrutura val passada. O microdriver deve armazenar o valor no membro XResolution da estrutura SCANINFO aprovada.

CMD_SETYRESOLUTION

Chamado pelo Driver de Flatbed WIA para definir a resolução de digitalização vertical. A resolução desejada em pixels é passada no membro lVal da estrutura val passada. O microdriver deve armazenar o valor no membro YResolution da estrutura SCANINFO aprovada.

CMD_STI_DEVICERESET

Chamado pelo Driver de Scanner Plano do WIA para redefinir o dispositivo em resposta a uma solicitação de Imagem Estática (STI). Esse comando normalmente é chamado apenas uma vez, durante a inicialização.

CMD_STI_DIAGNOSTIC

Chamado pelo Driver flatbed wia quando o usuário solicita um teste do dispositivo.

CMD_UNINITIALIZE

Desinicializar microdriver e fechar os identificadores de entrada/saída do dispositivo. O Driver WIA Flatbed fechará automaticamente o identificador de E/S do dispositivo no membro da matriz DeviceIOHandles da estrutura SCANINFO, no índice 0. Esse comando será enviado ao microdriver quando o driver WIA Flatbed estiver sendo descarregado.