GdPicture.NET.14.API
GdPicture14 Namespace / GdPictureImaging Class / TwainAcquireToMemoryFile Method / TwainAcquireToMemoryFile(String,Int32) Method
The path of the image file to create.
A Window Handle IE: Me.Handle. In most applications you can use nothing but on Citrix and WTS, this must be a top-level window or a child of a top level window.





In This Topic
TwainAcquireToMemoryFile(String,Int32) Method
In This Topic
Acquires a single image, from the currently selected Data Source to a file. This method uses the memory transfer mode. This method is ideal to reach the best transfer rate of the acquisition device. The output image compression should be negotiated with the TwainSetCompression() method.
Syntax
'Declaration
 
Public Overloads Function TwainAcquireToMemoryFile( _
   ByVal FilePath As String, _
   ByVal HANDLE As Integer _
) As GdPictureStatus
public GdPictureStatus TwainAcquireToMemoryFile( 
   string FilePath,
   int HANDLE
)
public function TwainAcquireToMemoryFile( 
    FilePath: String;
    HANDLE: Integer
): GdPictureStatus; 
public function TwainAcquireToMemoryFile( 
   FilePath : String,
   HANDLE : int
) : GdPictureStatus;
public: GdPictureStatus TwainAcquireToMemoryFile( 
   string* FilePath,
   int HANDLE
) 
public:
GdPictureStatus TwainAcquireToMemoryFile( 
   String^ FilePath,
   int HANDLE
) 

Parameters

FilePath
The path of the image file to create.
HANDLE
A Window Handle IE: Me.Handle. In most applications you can use nothing but on Citrix and WTS, this must be a top-level window or a child of a top level window.

Return Value

A member of the GdPictureStatus enumeration.
Remarks
By default, the default data source (DS) is opened, displays its dialog, and determines all the parameters of the acquisition and transfer. If you want to (try to) hide the DS dialog, see TwainSetHideUI. Before using this method check that the TWAIN state is >= 4 (TWAIN_SOURCE_OPEN) To get the TWAIN state, use the TwainGetState() method. To set the TWAIN state to 4, use the TwainOpenDefaultSource() or TwainOpenSource() method. Warning: To works, this method requires that the current Data source allows memory transfer mode. Use the TwainIsMemoryTransferModeAvailable() to check if the source support this mode of transfer.

This method requires the Document Capture (TWAIN / WIA) component to run.

See Also