Comandos necessários

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

CMD_GETCAPABILITIES

Chamado pelo WIA Flatbed Driver para obter informações do evento do botão. Três membros da estrutura VAL passada devem ser preenchidos: lVal deve ser ajustado para o número de botões; pGuid deve ser definido como uma matriz de GUIDs de eventos; ppButtonNames pode opcionalmente ser 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 de digitalização" ou "Botão de fax"). Se ppButtonNames estiver definido como NULL, o driver de mesa 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 mesa WIA para inicializar o microdriver e definir identificadores de E/S do dispositivo para valores válidos. Este comando será enviado ao microcontrolador quando o serviço WIA chamar o método IWiaMiniDrv::drvInitializeWia no Controlador de Cama Plana WIA.

O driver de flatbed WIA criará automaticamente um identificador de I/O de dispositivo e o colocará no membro da matriz DeviceIOHandles da estrutura SCANINFO passada no índice 0. O microdriver deve usar essa alça quando precisar se comunicar com o dispositivo. Se o microdriver precisar de identificadores de dispositivo adicionais (por exemplo, para usar vários tubos USB em massa), eles podem ser criados e armazenados na matriz DeviceIOHandles até um número máximo de MAX_IO_HANDLES. O driver de mesa WIA fechará automaticamente o identificador no índice 0, porque ele criou esse identificador durante a inicialização. As outras alças devem ser fechadas 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, para que o WIA Flatbed Driver possa validar automaticamente esses valores em relação aos intervalos legais para o dispositivo.

CMD_RESETSCANNER

Chamado pelo driver de mesa WIA para redefinir o dispositivo em resposta a uma solicitação de serviço WIA. O microdriver deve definir o dispositivo para o seu estado ligado. No Windows Vista, o driver de scanner de mesa WIA não usa esse comando. No entanto, os microdrivers devem continuar a suportar este comando para garantir o funcionamento correto no Windows XP e, possivelmente, com uma versão futura do WIA Flatbed Driver que possa usar este comando.

CMD_SETDATATYPE

Chamado pelo driver de mesa digitalizadora WIA 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 − Color de 24 bits

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

CMD_SETCONTRAST

Chamado pelo driver WIA de mesa digitalizadora para definir 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 Contraste da estrutura SCANINFO passada.

CMD_SETINTENSITY

Chamado pelo driver de scanner de mesa WIA para definir a intensidade ou o valor de 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 de mesa WIA para definir a resolução de varredura 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 passada.

CMD_SETYRESOLUTION

Chamado pelo WIA Flatbed Driver para definir a resolução de varredura 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 passada.

CMD_STI_DEVICERESET

Chamado pelo driver de scanner de mesa WIA para reinicializar o dispositivo em resposta a uma solicitação de imagem fixa (STI). Este comando normalmente é chamado apenas uma vez, durante a inicialização.

CMD_STI_DIAGNOSTIC

Chamado pelo WIA Flatbed Driver quando o usuário solicita um teste do dispositivo.

CMD_UNINITIALIZE

Desinicialize o microdriver e feche os controladores de E/S do dispositivo. O controlador de scanner de mesa WIA fechará automaticamente o identificador de E/S do dispositivo no elemento do array DeviceIOHandles da estrutura SCANINFO, na posição 0. Este comando será enviado para o microdriver quando o driver WIA Flatbed estiver a descarregar.