LWia::SelectDeviceDlg

Summary

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.

Syntax

#include "ltwrappr.h"

virtual L_INT LWia::SelectDeviceDlg(uDeviceType, uFlags)

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

• LTWIA
• 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

• LWia::SelectDevice
• LWia::GetSelectedDevice; LWia::Acquire
• LWia::AcquireToFile
• LWia::AcquireSimple
• LWia::InitSession
• LWia::EndSession
• Class Members

Topics

• Programming with LEADTOOLS Windows Image Acquisition (WIA) Functions
• How to Acquire from the WIA Source
• Managing WIA Sources
• WIA Functionality: Property Functions

Example

For an example, refer to LWia::IsAvailable.