L_WiaGetSelectedDevice

Summary

Gets a string pointer that contains the ID for currently selected device.

Syntax

#include "ltwia.h"

L_LTWIA_API L_TCHAR* EXT_FUNCTION L_WiaGetSelectedDevice(hSession)

Parameters

HWIASESSION hSession

Handle to an existing WIA session. This handle is obtained by calling the L_WiaInitSession function.

Returns

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

Comments

This feature is available in version 16 or higher.

Call this function to get a string that represents the ID for the currently selected device.

WIA does not have a default device selection. In order for this function to succeed be sure to call either L_WiaSelectDeviceDlg or L_WiaSelectDevice before calling this function.

Note that if you are using the L_WiaAcquireSimple function to automatically acquire from your device then it is not necessary to call either of the two mentioned functions above before calling the L_WiaGetSelectedDevice (L_WiaAcquireSimple function internally calls the L_WiaSelectDeviceDlg function and this will assure you have a device currently selected).

Required DLLs and Libraries

Platforms

LEADTOOLS WIA supports both 32-bit and 64-bit image acquisition for both WIA 1.0 (XP and earlier) and WIA 2.0 (VISTA and later).

See Also

Functions

Topics

Example

For an example, refer to L_WiaEnumDevices.

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

LEADTOOLS WIA C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.