CAP_IAFIELDA_VALUE

Description

Specifies the image address that will be assigned to the first sheet of paper captured by the scanner when scanning is started.

Application

Set CAP_IMAGEADDRESSENABLED to TRUE before accessing these fields. Refer to the section on Capability Ordering to correctly negotiate these settings. An application must set all the supported Image Addressing capabilities to guarantee a correct result.

If CAP_IAFIELD _LEVEL is TWIA_UNUSED, the value is ignored. If CAP_IAFIELD _LEVEL is TWIA_FIXED, then set the value to a text string. For any other value of CAP_IAFIELD _LEVEL set CAP_IAFIELD _VALUE to the numeric value that will be assigned to the first sheet of paper captured by the scanner when scanner is started.

Source

Values

Support this capability if the scanner supports image addressing and allows customizing of the image address format. Return TWRC_FAILURE / TWCC_CAPSEQERROR if CAP_IMAGEADDRESSENABLED is not set to TRUE.

When scanning is complete the value of these fields indicates the image address that will be assigned to the first sheet of paper captured by the scanner. This allows an application the option to resume scanning without renegotiating these values.

Type: TW_STR

Value after MSG_OPENDS: (may be remembered from a previous session)

After MSG_RESET/MSG_RESETALL: “1”

Containers

MSG_GET TW_ONEVALUE MSG_GETCURRENT TW_ONEVALUE MSG_GETDEFAULT TW_ONEVALUE MSG_SET TW_ONEVALUE

MSG_RESET TW_ONEVALUE

MSG_QUERYSUPPORT TW_ONEVALUE

Required By

None

TWAIN Version Introduced

Version 2.5

Related

CAP_IAFIELDA_LEVEL CAP_IAFIELDA_VALUE