LWIAPROPERTIES

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;

The LWIAPROPERTIES structure provides information about the available WIA properties.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro 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 (if you are using WIA 1.0) or WIA_IPS_DOCUMENT_HANDLING_SELECT property ID (if you are using 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 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 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. You can specify ALL_PAGES(= 0) to scan all pages in the document feeder.

 

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

pImageResolution

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

pDataTransfer

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

pImageEffects

A structure of type LWIAIMAGEEFFECTS that contains 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, you can 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 if your program requires a pointer.

LWIAPROPERTIES is used with the LWia::GetProperties and LWia::SetProperties functions.