L_TwainSetAcquirePageOptions

#include "lttw2.h"

L_INT EXT_FUNCTION L_TwainSetAcquirePageOptions(hSession, nPaperSize, nPaperDirection)

HTWAINSESSION hSession;	/* handle to an existing TWAIN session */
L_INT nPaperSize;	/* paper size */
L_INT nPaperDirection;	/* page orientation */

Sets the page size and orientation to be used when transferring data from the current TWAIN source.

Parameter	Description
HSession	Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession function.
nPaperSize	The page size to set. For more information on possible values, refer to www.twain.org/download.htm and click on TWAIN Specification (Version 1.9).
nPaperDirection	The page orientation to set. For more information on possible values, refer to www.twain.org/download.htm and click on TWAIN Specification (Version 1.9).

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function internally sets the page size capability ICAP_SUPPORTEDSIZES, and the page orientation capability ICAP_ORIENTATION. For more information on these capabilities, refer to www.twain.org/download.htm and click on TWAIN Specification (Version 1.9).

To get the current values of these capabilities, call the L_TwainGetAcquirePageOptions 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

Functions:	L_TwainSetTransferOptions, L_TwainGetTransferOptions, L_TwainGetSupportedTransferMode, L_TwainSetResolution, L_TwainGetResolution, L_TwainSetImageFrame, L_TwainGetImageFrame, L_TwainSetImageUnit, L_TwainGetImageUnit, L_TwainSetImageBitsPerPixel, L_TwainGetImageBitsPerPixel, L_TwainSetImageEffects, L_TwainGetImageEffects, L_TwainGetAcquirePageOptions, L_TwainSetRGBResponse, L_TwainShowProgress, L_TwainEnableDuplex, L_TwainGetDuplexOptions, L_TwainSetMaxXferCount, L_TwainGetMaxXferCount
Topics:	Getting and Setting Capabilities
	TWAIN Functionality: Capability Functions

Example

For an example, refer to L_TwainGetImageEffects.