Tamaños de página personalizados y automáticos

Una aplicación puede establecer el tamaño de página a través de la detección automática por el analizador o a través de valores personalizados. El enfoque utilizado por la aplicación viene determinado por la propiedad WIA_IPS_PAGE_SIZE , que puede tomar los valores WIA_PAGE_AUTO o WIA_PAGE_CUSTOM.

Si una aplicación establece WIA_IPS_PAGE_SIZE en cualquier valor distinto de WIA_PAGE_CUSTOM, el minidriver WIA debe ajustar los valores de WIA_IPS_PAGE_WIDTH y WIA_IPS_PAGE_HEIGHT a las dimensiones de la página en milésimas de pulgada (.001). El minidriver también debe ajustar los valores de WIA_IPS_XEXTENT y WIA_IPS_YEXTENT a las dimensiones de la página, en píxeles.

Si se cambia una configuración de extensión (WIA_IPS_XEXTENT o WIA_IPS_YEXTENT) a un valor que no coincide con la configuración actual de tamaño de página, el minidriver debe cambiar el valor de la propiedad WIA_IPS_PAGE_SIZE a WIA_PAGE_CUSTOM. El minidriver también debe modificar WIA_IPS_PAGE_WIDTH o WIA_IPS_PAGE_HEIGHT para aceptar la nueva configuración de extensión.

Si una aplicación establece la propiedad WIA_IPS_PAGE_SIZE en WIA_PAGE_CUSTOM, el área de selección actual no se ve afectada. El minidriver WIA debe obtener el diseño de imagen actual, empezando por la configuración actual de las propiedades WIA_IPS_XPOS y WIA_IPS_YPOS . Si la configuración de tamaño de página hace que el área de selección esté fuera de la cama del escáner, el minidriver debe ajustar automáticamente los valores de la WIA_IPS_XPOS y WIA_IPS_YPOS propiedades a valores válidos. Si las propiedades WIA_IPS_PAGE_SIZE y WIA_IPS_ORIENTATION se establecen al mismo tiempo y no son válidas cuando se aplican en combinación, el minidriver debe producir un error en la configuración de la aplicación devolviendo un error en el método IWiaMiniDrv::d rvValidateItemProperties .

Cuando se habilita la detección automática de tamaño de página, el controlador debe proporcionar información precisa sobre la dimensión de imagen solo después de completar la transferencia de los datos de imagen. Para las transferencias basadas en secuencias, se espera que el controlador actualice las dimensiones de imagen en el encabezado de imagen al final de la transferencia. Al principio de una nueva sesión, el valor de la propiedad WIA_IPS_PAGE_SIZE siempre debe establecerse en un valor distinto de WIA_PAGE_AUTO.

Cuando WIA_PAGE_AUTO se establece como el valor de WIA_IPS_PAGE_SIZE actual, es posible que el controlador tenga que transferir primero un encabezado de imagen que contenga dimensiones de imagen genéricas, luego transferir los datos de imagen y, a continuación, volver al principio de la secuencia de transferencia, actualizar el encabezado de imagen con las dimensiones de imagen reales (que se encuentran después de completar el examen), y vuelven a mover el índice de secuencia al final de la secuencia.

Cuando se establece WIA_PAGE_AUTO (elegido como valor predeterminado por el controlador o establecido por la aplicación), la aplicación no debe intentar procesar las dimensiones de imagen que describe el encabezado de imagen hasta que se complete toda la transferencia de imágenes.

Nota La capa de compatibilidad dentro del servicio WIA no agrega compatibilidad para WIA_IPS_PAGE_SIZE al elemento de ADF que se traduce desde un dispositivo WIA de Windows XP si la propiedad no es compatible con el elemento secundario del dispositivo. Las aplicaciones no deben esperar que un elemento de ADF admita siempre esta propiedad y siempre debe comprobar si se admite WIA_IPS_PAGE_SIZE en tiempo de ejecución. (Normalmente, las aplicaciones deben comprobar la compatibilidad con cualquier propiedad que se va a negociar).