SP_DRVINFO_DATA_V2_A结构 (setupapi.h)

项目
08/26/2023

SP_DRVINFO_DATA 结构包含有关驱动程序的信息。此结构是驱动程序信息列表的成员，可以与特定设备实例相关联，也可以与设备信息集全局关联。

语法

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;

成员

cbSize

SP_DRVINFO_DATA结构的大小（以字节为单位）。有关详细信息，请参阅本主题中的“备注”部分。

DriverType

此结构表示的驱动程序的类型。必须是以下值之一：

SPDIT_CLASSDRIVER

此结构表示类驱动程序。

SPDIT_COMPATDRIVER

此结构表示兼容的驱动程序。

Reserved

保留。仅限内部使用。

Description[LINE_LEN]

以 NULL 结尾的字符串，描述此驱动程序支持的设备。

MfgName[LINE_LEN]

以 NULL 结尾的字符串，其中包含此驱动程序支持的设备的制造商的名称。

ProviderName[LINE_LEN]

一个以 NULL 结尾的字符串，提供此驱动程序的提供程序。这通常是创建驱动程序或 INF 文件的组织的名称。 ProviderName 可以是空字符串。

DriverDate

驱动程序的日期。从 INF 文件中的 DriverVer 条目。有关 DriverVer 条目的详细信息，请参阅 INF DDInstall 部分。

DriverVersion

驱动程序的版本。从 INF 文件中的 DriverVer 条目。

注解

在 SetupAPI.h 中，此结构等同于 SP_DRVINFO_DATA_V1 或 SP_DRVINFO_DATA_V2，具体取决于是否在源代码中包含以下行：

#define  USE_SP_DRVINFO_DATA_V1 1

仅当组件必须在 Windows 98、Millennium Edition 或 Windows NT 上运行时才定义此标识符。如果组件仅在 Windows 2000 及更高版本的 Windows 中运行，请不要定义标识符。如果未定义标识符，则使用 SP_DRVINFO_DATA_V2。

SP_DRVINFO_DATA_V1不包含 DriverDate 和 DriverVersion 成员。

采用 SP_DRVINFO_DATA 结构作为参数的 SetupDiXxx 函数验证所提供的结构的 cbSize 成员是否等于结构的大小（以字节为单位）。如果未为输入参数正确设置 cbSize 成员，该函数将失败，并将错误代码设置为 ERROR_INVALID_PARAMETER。如果未为输出参数正确设置 cbSize 成员，则函数将失败，并将错误代码设置为 ERROR_INVALID_USER_BUFFER。

注意

setupapi.h 标头将 SP_DRVINFO_DATA_V2 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。