SP_DRVINFO_DATA_V2_W结构（setupapi.h）

项目
11/20/2024

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

语法

typedef struct _SP_DRVINFO_DATA_V2_W {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  WCHAR     Description[LINE_LEN];
  WCHAR     MfgName[LINE_LEN];
  WCHAR     ProviderName[LINE_LEN];
  FILETIME  DriverDate;
  DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_W, *PSP_DRVINFO_DATA_V2_W;

成员

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 成员。

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

注意

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