LWia::GetSelectedDevice

Summary

Gets a string pointer containing the ID for the currently selected device.

Syntax

#include "ltwrappr.h"

virtual L_TCHAR * LWia::GetSelectedDevice()

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.

Call [LWia:GetSelectedDevice to get a string representing the ID for the currently selected device.

WIA does not have a default device selection. In order for [LWia:GetSelectedDevice to succeed, be sure to call either LWia::SelectDeviceDlg or LWia::SelectDevice before calling [LWia:GetSelectedDevice.

LWia::AcquireSimple Exception

When using LWia::AcquireSimple for automatic acquisition, it is not necessary to call either of the two functions mentioned above before calling [LWia:GetSelectedDevice. LWia::AcquireSimple calls LWia::SelectDeviceDlg internally, ensuring that a device is currently selected.

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::GetSelectedDeviceType
• LWia::SelectDeviceDlg
• LWia::AcquireSimple
• LWia::InitSession
• LWia::EndSession
• Class Members

Topics

• Managing WIA Sources
• WIA Functionality: Property Functions

Example

For an example, refer to LWia::EnumDevices.