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) |