Comandos opcionais

Os comandos a seguir podem ser implementados pelo microdriver, mas não é necessário fazer isso.

CMD_GETSUPPORTEDFILEFORMATS

Chamado pelo driver WIA Flatbed para obter o número de formatos de arquivo adicionais. Dois membros da estrutura val passada devem ser preenchidos: lVal deve ser definido como 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 sã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 Flatbed WIA os adiciona automaticamente. O microdriver não deve adicioná-los à sua lista estendida.

Esse comando é opcional, a menos que o dispositivo possa dar suporte a formatos de arquivo extras.

CMD_GETSUPPORTEDMEMORYFORMATS

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

Os formatos de imagem sã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 Flatbed WIA os adiciona automaticamente. O microdriver não deve adicioná-los à sua lista estendida.

Esse comando é opcional, a menos que o dispositivo possa dar suporte a formatos de memória extras.

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 de formato de imagem. O microdriver deve salvar essa ID de formato de imagem em seu contexto privado, a fim de acompanhar a configuração de formato de imagem atual.

Os microdrivers são necessários para dar suporte a esse comando somente se relatarem 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 relatar que ele dá suporte ao formato JPEG, todo o JPEG deverá ser transferido, não apenas os bits de imagem.

O driver de classe possui a memória apontada pelo membro pGuid da estrutura VAL, portanto, o microdriver não deverá 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 dados nos buffers apontados pelos parâmetros pBuffer e pReceived , conforme apropriado.

Drivers que dão suporte apenas a 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, pois o driver de classe manipula todas as transferências de dados usando os formatos padrão.

CMD_SETSCANMODE

Chamado pelo Driver WIA Flatbed para definir o modo de digitalização -- pré-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 verificação de visualização

• SCANMODE_FINALSCAN – Modo de verificação final

CMD_SETSTIDEVICEHKEY

Chamado pelo Driver de Flatbed WIA para permitir que o microdriver leia as entradas do Registro na seção do Registro instalada. Esse comando fornece o HKEY do registro instalado do dispositivo STI para o microdriver, para que ele possa acessar valores de registro privados para seu dispositivo. O membro pHandle da estrutura VAL conterá um ponteiro para o HKEY fornecido ao Driver Flatbed do WIA 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 esse HKEY. Consulte arquivos INF para dispositivos WIA para obter mais informações.