Share via

DeviceSearchType (Compact 2013)

  • Article

3/26/2014

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, pvSearchParammight be L"COM*" to search for all COMx: devices.
  • DeviceSearchByDeviceName
    Search by device name. For example, in a call to FindFirstDevice, pvSearchParammight 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, pvSearchParammust be a GUID pointer.
  • DeviceSearchByParent
    Search by parent. For example, in a call to FindFirstDevice, pvSearchParamis an activation handle value returned from ActivateDeviceEx.

Requirements

Header

winbase.h

See Also

Reference

Device Manager Enumerations
ActivateDeviceEx
FindFirstDevice
FindNextDevice