Share via


DeviceSearchType

Other versions of this page are also available for the following:

Windows Mobile SupportedWindows Embedded CE Supported

8/28/2008

This enumeration represents the ways to look for a matching device and is passed as a parameter to FindFirstDevice and FindNextDevice.

Syntax

typedef enum {
  DeviceSearchByLegacyName, 
  DeviceSearchByDeviceName, 
  DeviceSearchByBusName, 
  DeviceSearchByGuid, 
  DeviceSearchByParent 
} DeviceSearchType;

Elements

  • DeviceSearchByLegacyName
    Search by a legacy device name. For example, in a call to FindFirstDevice, pvSearchParam might be L"COM*" to search for all COMx: devices.
  • DeviceSearchByDeviceName
    Search by device name. For example, in a call to FindFirstDevice, pvSearchParam might be L"$device\\COM*" to search for all COMx devices.
  • DeviceSearchByBusName
    Search by bus name. For example, in a call to FindFirstDevice, pvSearchParam might be L"PCI_0_3*" to search for PCI_0_3_0, PCI_0_3_1 and so on.
  • DeviceSearchByGuid
    Search by GUID. For example, in a call to FindFirstDevice, pvSearchParam must be a GUID pointer.
  • DeviceSearchByParent
    Search by parent. For example, in a call to FindFirstDevice, pvSearchParam is an activation handle value returned from ActivateDeviceEx.

Requirements

Header winbase.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ActivateDeviceEx
FindFirstDevice
FindNextDevice