Tamanhos de página personalizados e automáticos

Um aplicativo pode definir o tamanho da página por meio da detecção automática pelo verificador ou por meio de valores personalizados. A abordagem usada pelo aplicativo é determinada pela propriedade WIA_IPS_PAGE_SIZE , que pode levar os valores WIA_PAGE_AUTO ou WIA_PAGE_CUSTOM.

Se um aplicativo definir WIA_IPS_PAGE_SIZE para qualquer valor diferente de WIA_PAGE_CUSTOM, o minidriver WIA deverá ajustar os valores de WIA_IPS_PAGE_WIDTH e WIA_IPS_PAGE_HEIGHT às dimensões da página em milésimos de polegada (0,001). O minidriver também deve ajustar os valores de WIA_IPS_XEXTENT e WIA_IPS_YEXTENT para as dimensões da página, em pixels.

Se uma configuração de extensão (WIA_IPS_XEXTENT ou WIA_IPS_YEXTENT) for alterada para um valor que não corresponda à configuração de tamanho de página atual, o minidriver deverá alterar o valor da propriedade WIA_IPS_PAGE_SIZE para WIA_PAGE_CUSTOM. O minidriver também deve modificar WIA_IPS_PAGE_WIDTH ou WIA_IPS_PAGE_HEIGHT para concordar com a nova configuração de extensão.

Se um aplicativo definir a propriedade WIA_IPS_PAGE_SIZE como WIA_PAGE_CUSTOM, a área de seleção atual não será afetada. O minidriver WIA deve obter o layout da imagem atual, começando pelas configurações atuais das propriedades WIA_IPS_XPOS e WIA_IPS_YPOS . Se a configuração de tamanho de página fizer com que a área de seleção fique fora da cama do verificador, o minidriver deverá ajustar automaticamente os valores do WIA_IPS_XPOS e WIA_IPS_YPOS propriedades para configurações válidas. Se as propriedades WIA_IPS_PAGE_SIZE e WIA_IPS_ORIENTATION forem definidas ao mesmo tempo e forem inválidas quando forem aplicadas em combinação, o minidriver deverá falhar nas configurações do aplicativo retornando um erro no método IWiaMiniDrv::d rvValidateItemProperties .

Quando a detecção automática de tamanho de página estiver habilitada, o driver deverá fornecer informações precisas da dimensão da imagem somente depois de concluir a transferência dos dados da imagem. Para transferências baseadas em fluxo, espera-se que o driver atualize as dimensões de imagem no cabeçalho da imagem no final da transferência. No início de uma nova sessão, o valor da propriedade WIA_IPS_PAGE_SIZE deve ser sempre definido como um valor diferente de WIA_PAGE_AUTO.

Quando WIA_PAGE_AUTO é definido como o valor WIA_IPS_PAGE_SIZE atual, o driver pode precisar primeiro transferir um cabeçalho de imagem que contém dimensões de imagem genéricas, transferir os dados da imagem e, em seguida, voltar para o início do fluxo de transferência, atualizar o cabeçalho da imagem com as dimensões de imagem reais (encontradas após a verificação concluída), e mova o índice de fluxo de volta para o final do fluxo.

Quando WIA_PAGE_AUTO é definido (escolhido como o valor padrão pelo driver ou definido pelo aplicativo), o aplicativo não deve tentar processar as dimensões de imagem que o cabeçalho da imagem descreve até que toda a transferência de imagem seja concluída.

Nota A camada de compatibilidade dentro do serviço WIA não adiciona suporte para WIA_IPS_PAGE_SIZE ao item do ADF que é traduzido de um dispositivo WIA do Windows XP se a propriedade não tiver suporte no item filho do dispositivo. Os aplicativos não devem esperar que um item do ADF sempre dê suporte a essa propriedade e sempre devem marcar se WIA_IPS_PAGE_SIZE tiver suporte em tempo de execução. (Normalmente, os aplicativos devem marcar o suporte para qualquer propriedade que deve ser negociada.)