SP_DEVINFO_DATA结构 (setupapi.h)

SP_DEVINFO_DATA结构定义设备实例,该实例是设备信息集的成员。

语法

typedef struct _SP_DEVINFO_DATA {
  DWORD     cbSize;
  GUID      ClassGuid;
  DWORD     DevInst;
  ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;

成员

cbSize

SP_DEVINFO_DATA结构的大小(以字节为单位)。 有关更多信息,请参见下面的“备注”部分。

ClassGuid

设备的安装类的 GUID。

DevInst

设备实例的不透明句柄 (也称为 开发节点) 的句柄。

某些函数(如 SetupDiXxx 函数)采用整个SP_DEVINFO_DATA结构作为输入来标识设备信息集中的设备。 其他函数(如 CM_Xxx 函数(如 CM_Get_DevNode_Status)将此 DevInst 句柄作为输入。

Reserved

保留。 仅限内部使用。

注解

SP_DEVINFO_DATA结构标识设备信息集中的设备。 例如,当 Windows 向类安装程序和共同安装程序发送 DIF_INSTALLDEVICE 请求时,它包括设备信息集的句柄和指向指定特定设备的SP_DEVINFO_DATA的指针。 除了 DIF 请求,此结构还用于某些 SetupDiXxx 函数。

将SP_DEVINFO_DATA结构用作参数的 SetupDiXxx 函数验证所提供的结构的 cbSize 成员是否等于结构的大小(以字节为单位)。 如果未正确为输入参数设置 cbSize 成员,该函数将失败并设置ERROR_INVALID_PARAMETER的错误代码。 如果未正确为输出参数设置 cbSize 成员,该函数将失败并设置ERROR_INVALID_USER_BUFFER的错误代码。

要求

   
标头 setupapi.h (包括 Setupapi.h)

请参阅

SP_DEVINFO_LIST_DETAIL_DATA