Share via


FindFirstDevice (Compact 2013)

3/26/2014

This function searches for device information and fills a DEVMGR_DEVICE_INFORMATION structure with this information.

Syntax

HANDLE FindFirstDevice(
  DeviceSearchType searchType,
  LPCVOID pvSearchParam,
  PDEVMGR_DEVICE_INFORMATION pdi
);

Parameters

  • searchType
    [in] Method of searching for a device. Set to an element of the DeviceSearchType enumeration.
  • pvSearchParam
    [in] Pointer to a string, pointer to a GUID, or an activation handle. The following table shows examples of these based on the element of DeviceSearchType passed in searchType.

    searchType

    pvSearchParam

    DeviceSearchByLegacyName

    L"COM*" for all COMx: devices.

    DeviceSearchByDeviceName

    L"COM*" for all COMx devices.

    DeviceSearchByBusName

    L"PCI_0_3*" for PCI_0_3_0, PCI_0_3_1 and so on.

    DeviceSearchByGuid

    Pointer to a GUID.

    DeviceSearchByParent

    Activation handle value from ActivateDeviceEx.

  • pdi
    [out] Pointer to a DEVMGR_DEVICE_INFORMATION structure to store the device's information.

Return Value

If successful, FindFirstDevice returns a search handle that can be used in subsequent calls to FindNextDevice. If the function is not successful, it returns INVALID_HANDLE_VALUE. To obtain extended error information, the application can call the GetLastError function.

Remarks

Wildcards are supported in name-based searches. Unnamed devices can be found using a zero-length search string.

Close the handle with FindClose when searching is complete.

Requirements

Header

winbase.h

See Also

Reference

Device Manager Functions
DeviceSearchType
DEVMGR_DEVICE_INFORMATION
FindNextDevice

Other Resources

FindClose