SP_DEVINFO_DATA

An SP_DEVINFO_DATA structure defines a device instance that is a member of a device information set.

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

Members

cbSize

The size, in bytes, of the SP_DEVINFO_DATA structure.

ClassGuid

The GUID of the device's setup class.

DevInst

An opaque handle to the device instance (also known as a handle to the devnode).

Some functions, such as SetupDiXxx functions, take the whole SP_DEVINFO_DATA structure as input to identify a device in a device information set. Other functions, such as CM_Xxx functions like CM_Get_DevNode_Status, take this DevInst handle as input.

Reserved

Reserved. For internal use only.

Comments

An SP_DEVINFO_DATA structure identifies a device in a device information set. For example, when Setup sends a DIF_INSTALLDEVICE request to a class installer and co-installers, it includes a handle to a device information set and a pointer to an SP_DEVINFO_DATA that specifies the particular device. Besides DIF requests, this structure is also used in some SetupDiXxx functions.

See Also

SP_DEVINFO_LIST_DETAIL_DATA