LEADTOOLS WIA (Leadtools.Wia assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.30
EnumDevices Method
See Also 
Leadtools.Wia Namespace > WiaSession Class : EnumDevices Method



Enumerates all available system WIA devices connected to the user's machine.

Syntax

Visual Basic (Declaration) 
Public Sub EnumDevices() 
Visual Basic (Usage)Copy Code
Dim instance As WiaSession
 
instance.EnumDevices()
C# 
public void EnumDevices()
C++/CLI 
public:
void EnumDevices(); 

Example

Visual BasicCopy Code
Public Sub EnumDevicesExample(ByVal parent As IWin32Window)
   If (Not WiaSession.IsAvailable(WiaVersion.Version1)) Then
      MessageBox.Show("WIA version 1.0 not installed.")
      Return
   End If

   Dim session As WiaSession = New WiaSession()
   session.Startup(WiaVersion.Version1)

   Dim res As DialogResult = session.SelectDeviceDlg(parent, WiaDeviceType.Default, WiaSelectSourceFlags.NoDefault)
   If res <> DialogResult.OK Then
      MessageBox.Show("Error selecting WIA device.")
      session.Shutdown()
      Return
   End If

   AddHandler session.EnumDevicesEvent, AddressOf session_EnumDevicesEvent

   Console.WriteLine("Available WIA Devices:" & Constants.vbLf)
   session.EnumDevices()

   RemoveHandler session.EnumDevicesEvent, AddressOf session_EnumDevicesEvent

   session.Shutdown()
End Sub

Private Sub session_EnumDevicesEvent(ByVal sender As Object, ByVal e As WiaEnumDevicesEventArgs)
   Dim strMsg As String = String.Empty

   ' print out some information about each device found into the console window.
   strMsg = String.Format(Constants.vbTab & "Device Name: {0}" & Constants.vbLf + Constants.vbTab & "Device Id: {1}" & Constants.vbLf + Constants.vbTab & "Device Description: {2}" & Constants.vbLf + Constants.vbLf, e.DeviceName, e.DeviceID, e.DeviceDesc)
   Console.WriteLine(strMsg)
End Sub
C#Copy Code
public void EnumDevicesExample(IWin32Window parent)
{
   if (!WiaSession.IsAvailable(WiaVersion.Version1))
   {
      MessageBox.Show("WIA version 1.0 not installed.");
      return;
   }

   WiaSession wiaSession = new WiaSession();
   wiaSession.Startup(WiaVersion.Version1);

   DialogResult res = wiaSession.SelectDeviceDlg(parent, WiaDeviceType.Default, WiaSelectSourceFlags.NoDefault);
   if (res != DialogResult.OK)
   {
      MessageBox.Show("Error selecting WIA device.");
      wiaSession.Shutdown();
      return;
   }

   wiaSession.EnumDevicesEvent += new EventHandler<WiaEnumDevicesEventArgs>(wiaSession_EnumDevicesEvent);

   Console.WriteLine("Available WIA Devices:\n");
   wiaSession.EnumDevices();

   wiaSession.EnumDevicesEvent -= new EventHandler<WiaEnumDevicesEventArgs>(wiaSession_EnumDevicesEvent);

   wiaSession.Shutdown();
}

void wiaSession_EnumDevicesEvent(object sender, WiaEnumDevicesEventArgs e)
{
   string strMsg = string.Empty;

   // print out some information about each device found into the console window.
   strMsg = string.Format("\tDevice Name: {0}\n\tDevice Id: {1}\n\tDevice Description: {2}\n\n", e.DeviceName, e.DeviceID, e.DeviceDesc);
   Console.WriteLine(strMsg);
}

Remarks

This function will enumerate all available system WIA devices connected to the user's machine.

Information about each device found, like the device ID, device name and device description, can be retrieved by using the WiaSession.EnumDevicesEvent event. To do so, add this event when enumerating the available WIA devices. To cancel the enumeration process add this event and set the Cancel member of the WiaEnumDevicesEventArgs to true.

For more information, refer to Managing WIA Sources.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also