Comandos opcionais

Os comandos a seguir podem ser implementados pelo microdriver, mas não é necessário fazê-lo.

CMD_GETSUPPORTEDFILEFORMATS

Chamado pelo WIA Flatbed Driver para obter o número de formatos de arquivo adicionais. Dois membros da estrutura VAL passada devem ser preenchidos: lVal deve ser configurado para o número de formatos de arquivo adicionais; pGuid deve apontar para uma matriz de GUIDs de formato de imagem. A memória alocada para essa matriz pertence ao microdriver e só deve ser liberada por ele.

Os formatos de imagem estão listados em wiadef.h ou podem ser definidos como formatos personalizados. Observe que, como os formatos BMP (ficheiro) e MEMORYBMP (memória) são formatos necessários, o driver de scanner plano WIA os adiciona automaticamente. O microdriver não deve adicioná-los à sua lista estendida.

Este comando é opcional, a menos que o dispositivo possa suportar formatos de arquivo extras.

CMD_GETSUPPORTEDMEMORYFORMATS

Chamado pelo controlador de scanner de mesa WIA para obter o número de formatos de memória adicionais. Dois membros da estrutura VAL passada devem ser preenchidos: lVal deve ser definido para o número de formatos de memória adicionais; O pGuid deve apontar para uma matriz de GUIDs de formato de imagem. A memória alocada para essa matriz pertence ao microdriver e só deve ser liberada por ele.

Os formatos de imagem estão listados em wiadef.h ou podem ser definidos como formatos personalizados. Observe que, como os formatos BMP (arquivo) e MEMORYBMP (memória) são formatos necessários, o driver de mesa WIA os adiciona automaticamente. O microdriver não deve adicioná-los à sua lista estendida.

Este comando é opcional, a menos que o dispositivo possa suportar formatos de memória extra.

CMD_SETFORMAT

O driver de classe envia esse comando para definir o formato atual conforme solicitado pelo aplicativo. O membro pGuid da estrutura VAL contém o GUID do formato de imagem. O microdriver deve salvar esse ID de formato de imagem em seu contexto privado, a fim de acompanhar a configuração de formato de imagem atual.

Microdrivers são necessários para suportar este comando somente se reportarem formatos estendidos. Como o driver de classe não tem como validar dados em formatos estendidos, é responsabilidade do microdriver gerar os dados adequados. Ao transferir dados em um formato estendido, todos os dados devem ser transferidos, incluindo cabeçalhos de imagem. Por exemplo, se o driver informar que ele suporta o formato JPEG, todo o JPEG deverá ser transferido, não apenas os bits da imagem.

O driver de classe possui a memória apontada pelo membro pGuid da estrutura VAL, portanto, o microdriver não deve liberá-la.

Observe que esse comando não afeta a maneira como um microdriver responde a chamadas para sua função Scan . Como de costume, o microdriver deve verificar os valores dos parâmetros lPhase, pScanInfo e lLength dessa função e colocar os dados nos buffers apontados pelos parâmetros pBuffer e pReceived conforme apropriado.

Os drivers que suportam apenas arquivos nos formatos WiaImgFmt_BMP e WiaImgFmt_MEMORYBMP (os formatos padrão para microdrivers) podem receber o comando CMD_SETFORMAT. Esses drivers podem ignorar esse comando, porque o driver de classe lida com todas as transferências de dados usando os formatos padrão.

CMD_SETSCANMODE

Chamado pelo WIA Flatbed Driver para definir o modo de verificação - visualização ou final - do dispositivo do microdriver. O membro lVal da estrutura VAL conterá um dos seguintes valores, ambos definidos em wiamicro.h:

• SCANMODE_PREVIEWSCAN − Modo de pré-visualização

• SCANMODE_FINALSCAN − Modo de verificação final

CMD_SETSTIDEVICEHKEY

Chamado pelo WIA Flatbed Driver para permitir que o microdriver leia entradas de registo na seção de registo instalada. Este comando fornece a chave de registro HKEY instalada do dispositivo STI ao microdriver, para que este possa aceder a valores de registro específicos para o seu dispositivo. O membro pHandle da estrutura VAL conterá um ponteiro para o HKEY dado ao WIA Flatbed Driver durante o método IStiUSD::Initialize da STI. Este é o HKEY de nível superior da seção do dispositivo instalado. A chave DeviceData pode ser aberta diretamente usando este HKEY. Consulte Arquivos INF para dispositivos WIA para obter mais informações.