LWia::SelectDeviceDlg

#include "ltwrappr.h"

virtual L_INT LWia::SelectDeviceDlg(uDeviceType, uFlags)

Creates and displays the Select Device dialog box so a WIA device for image acquisition can be selected. Specify the parent window for this dialog by calling the LScanner::SetWindow function.

Parameters

L_UINT32 uDeviceType

Specifies which type of WIA device to use. Possible values are:

Value Meaning
WiaDeviceTypeDefault Generic WIA device. During device enumerations, this constant is used to enumerate all WIA devices. This is the default value.
WiaDeviceTypeScanner The device is a scanner.
WiaDeviceTypeDigitalCamera The device is a camera. Cameras are not supported by Windows Vista and later.
WiaDeviceTypeStreamingVideo The device contains streaming video. Streaming video is not supported by Windows Server 2003, Windows Vista, or later.

 

L_UINT32 uFlags

Specifies dialog box behavior. Possible values are:

Value Meaning
0 Use the default behavior. This is the default value.
L_WIA_SELECT_DEVICE_NODEFAULT Display the dialog box even if there is only one matching device.

Returns

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

Comments

This feature is available in LEADTOOLS version 16 or higher.

Creates and displays the Select Device dialog box so a WIA device for image acquisition can be selected.

Use the uDeviceType parameter to specify which types of devices to display in the dialog.

If only one device meets the specification, the [LWia:SelectDeviceDlg does not display the Select Device dialog box. Override this behavior and force [LWia:SelectDeviceDlg to display the Select Device dialog box by passing L_WIA_SELECT_DEVICE_NODEFAULT as the value for the uFlags parameter.

Notes

WIA 2.0 does not support cameras or streaming video.

If you are using the high-level LWia::AcquireSimple, you do not need to call LWia::InitSession, LWia::SelectDevice, or LWia::EndSession because it handles session initialization, device selection, and session end automatically.

Required DLLs and Libraries

Help Version 20.0.2020.4.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS WIA C++ Class Library Help