L_WiaGetSelectedDeviceType

#include "ltwia.h"

L_LTWIA_API L_INT EXT_FUNCTION L_WiaGetSelectedDeviceType(hSession, puDeviceType)

HWIASESSION hSession;

/* handle to an existing WIA session */

L_UINT32 * puDeviceType;

/* pointer to variable of type L_UINT to receive the selected device type */

Gets the currently selected device type.

Parameter

Description

hSession

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

puDeviceType

The type if the currently selected device. Possible values are:

 

Value

Meaning

 

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.

Returns

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 determine the currently selected device type.

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.

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.

Platforms

Earlier and later operating systems than Windows XP for WIA Version 1.

Windows VISTA or later for WIA Version 2.

See Also

Functions:

L_WiaGetSelectedDevice, L_WiaSelectDevice, L_WiaSelectDeviceDlg, L_WiaAcquireSimple, L_WiaInitSession, L_WiaEndSession.

Topics:

Managing WIA Sources

 

WIA Functionality: Property Functions

Example

For an example, refer to L_WiaEnumDevices.