LWIAPROPERTIES

Summary

The LWIAPROPERTIES structure provides information about the available WIA properties.

Syntax

typedef struct _LWIAPROPERTIES 
{ 
   L_UINT uStructSize; 
   L_INT nScanningMode; 
   L_INT nImageType; 
   L_INT nOrientation; 
   L_INT nMaxNumOfPages; 
   pLWIAIMAGERESOLUTION  pImageResolution; 
   pLWIADATATRANSFER pDataTransfer; 
   pLWIAIMAGEEFFECTS pImageEffects; 
} LWIAPROPERTIES,   * pLWIAPROPERTIES; 

Members

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() operator to calculate this value.

nScanningMode

Contains the scanner acquisition source and mode.

For a list of all available values, refer to the Microsoft Windows SDK Documentation for the WIA_DPS_DOCUMENT_HANDLING_SELECT property ID (WIA 1.0) or WIA_IPS_DOCUMENT_HANDLING_SELECT property ID (WIA 2.0).

nImageType

Contains the application's intended use of the image. The device uses this value to change its settings. The settings changed depend upon how the image will be used.

For a list of all available values, refer to the Microsoft Windows SDK Documentation for the WIA_IPS_CUR_INTENT property ID.

nOrientation

Contains the original orientation of a page or image to be acquired.

For a list of all available values, refer to the Microsoft Windows SDK Documentation for the WIA_IPS_ORIENTATION property ID.

nMaxNumOfPages

Contains the current number of pages to be acquired from an automatic document feeder. Specify ALL_PAGES(= 0) to scan all pages in the document feeder.

For more information about this property, refer to the Microsoft Windows SDK Documentation for the WIA_IPS_PAGES property ID.

pImageResolution

A structure of type LWIAIMAGERESOLUTION containing image resolution data for the WIA source.

pDataTransfer

A structure of type LWIADATATRANSFER containing data transfer information for the WIA source.

pImageEffects

A structure of type LWIAIMAGEEFFECTS containing image effects information for the WIA source.

Comments

This feature is available in LEADTOOLS version 16 or higher.

pLWIAPROPERTIES is a pointer to an LWIAPROPERTIES structure. If the function parameter type is pLWIAPROPERTIES, declare an LWIAPROPERTIES variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pWIAPROPERTIES variable is necessary only for programs requiring a pointer.

Usage

• LWia::GetProperties
• LWia::SetProperties