L_TwainGetResolution
#include "lttwn.h"
L_LTTWN_API L_INT L_TwainGetResolution(hSession, pXRes, pYRes)
HTWAINSESSION hSession; |
/* handle to an existing TWAIN session */ |
pTW_FIX32 pXRes; |
/* pointer to a variable */ |
pTW_FIX32 pYRes; |
/* pointer to a variable */ |
Gets the current horizontal and vertical resolution used to transfer images from the current TWAIN source.
Parameter |
Description |
hSession |
Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession function. |
pXRes |
Pointer to a variable to be updated with the current horizontal resolution value. |
pYRes |
Pointer to a variable to be updated with the current vertical resolution value. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function gets the horizontal and vertical resolution capability values ICAP_XRESOLUTION and ICAP_YRESOLUTION. For more information on these capabilities, refer to www.twain.org/download.htm and click on TWAIN Specification (Version 1.9).
To set the resolution values, call the L_TwainSetResolution function.
This function should be called after calling the L_TwainStartCapsNeg function and before calling the L_TwainEndCapsNeg function.
Required DLLs and Libraries
LTTWN For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
Example
For an example, refer to L_TwainSetResolution.