SP_DRVINFO_DATA_V2_A structure (setupapi.h)

Article
11/20/2024

An SP_DRVINFO_DATA structure contains information about a driver. This structure is a member of a driver information list that can be associated with a particular device instance or globally with a device information set.

Syntax

typedef struct _SP_DRVINFO_DATA_V2_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
  FILETIME  DriverDate;
  DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_A, *PSP_DRVINFO_DATA_V2_A;

Members

cbSize

The size, in bytes, of the SP_DRVINFO_DATA structure. For more information, see the Remarks section in this topic.

DriverType

The type of driver represented by this structure. Must be one of the following values:

SPDIT_CLASSDRIVER

This structure represents a class driver.

SPDIT_COMPATDRIVER

This structure represents a compatible driver.

Reserved

Reserved. For internal use only.

Description[LINE_LEN]

A NULL-terminated string that describes the device supported by this driver.

MfgName[LINE_LEN]

A NULL-terminated string that contains the name of the manufacturer of the device supported by this driver.

ProviderName[LINE_LEN]

A NULL-terminated string giving the provider of this driver. This is typically the name of the organization that creates the driver or INF file. ProviderName can be an empty string.

DriverDate

Date of the driver. From the DriverVer entry in the INF file. See the INF DDInstall Section for more information about the DriverVer entry.

DriverVersion

Version of the driver. From the DriverVer entry in the INF file.

Remarks

In SetupAPI.h, this structure equates to either SP_DRVINFO_DATA_V1 or SP_DRVINFO_DATA_V2, based on whether you include the following line in your source code:

#define  USE_SP_DRVINFO_DATA_V1 1

Define this identifier only if your component must run on Windows 98 or Millennium Edition, or on Windows NT. If your component is run only in Windows 2000 and later versions of Windows, do not define the identifier. If the identifier is not defined, SP_DRVINFO_DATA_V2 is used.

SP_DRVINFO_DATA_V1 does not contain DriverDate and DriverVersion members.

SetupDiXxx functions that take an SP_DRVINFO_DATA structure as a parameter verify that the cbSize member of the supplied structure is equal to the size, in bytes, of the structure. If the cbSize member is not set correctly for an input parameter, the function will fail and set an error code of ERROR_INVALID_PARAMETER. If the cbSize member is not set correctly for an output parameter, the function will fail and set an error code of ERROR_INVALID_USER_BUFFER.

Note

The setupapi.h header defines SP_DRVINFO_DATA_V2 as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Header	setupapi.h (include Setupapi.h)

Share via