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