GdPictureImaging.TwainAcquireToDib Method

Acquires a single image, from the currently selected Data Source to a DIB handle.

public IntPtr TwainAcquireToDib(
    IntPtr HANDLE
);

Visual Basic

Public Function TwainAcquireToDib(
    ByVal HANDLE As IntPtr
) As IntPtr

Parameters

Parameters	Description
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.

Returns

0: The bitmap could not created. Use the GetStat(), TwainGetLastResultCode() and TwainGetLastConditionCode() functions for diagnosing the error.

Non-zero: DIB handle.

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 function check that the TWAIN state is >= 4 (TWAIN_SOURCE_OPEN)

To get the TWAIN state, use the TwainGetState() function.

To set the TWAIN state to 4, use the TwainOpenDefaultSource() or TwainOpenSource() function.