SetupDi系列函数记录之SetupDiGetClassDevs

SetupDiGetClassDevs

功能：

根据指定的设备信息，返回本机上该设备信息的设备信息集。

 

函数原型：

WINSETUPAPI HDEVINFOSetupDiGetClassDevs( 

    CONST GUID*ClassGuid, 

    PCWSTR     Enumerator, 

    HWND       hwndParent, 

    DWORD      Flags

);

参数：

 

ClassGuid：

指向设备设置类或设备接口类的指针，也可以为NULL.

   例如打印机

static GUID GUID_DEVINTERFACE_USBPRINTER = 
{ 0xA5DCBF10L, 0x6530, 0x11D2, { 0x90, 0x1F, 0x00, 0xC0, 0x4F, 0xB9, 0x51, 0xED} };

 

Enumerator：

   一般为NULL,详细请参考点击打开链接。

 

hwndParent:

   一般为NULL。

 

Flags：

   过滤设备信息。可通过按位组合使用。    

 

DIGCF_DEFAULT ：        与系统默认设备相关的设备

    DIGCF_PRESENT：        当前存在的设备

    DIGCF_ALLCLASSES：     所有已安装的设备

    DIGCF_PROFILE：        当前硬件配置文件中的设备

    DIGCF_DEVICEINTERFACE： 所有支持设备

 

返回值：

    若执行失败，返回INVALID_HANDLE_VALUE，

执行成功，返回一个handle，其指向包含所有匹配的设备信息集。