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