UMDF_VERSION_DATA 结构 (wudfddi_types.h)

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

UMDF_VERSION_DATA 结构描述框架的版本。

语法

typedef struct UMDF_VERSION_DATA {
  ULONG MajorNumber;
  ULONG MinorNumber;
  ULONG ServiceNumber;
} UMDF_VERSION_DATA, *PUMDF_VERSION_DATA;

成员

MajorNumber

一个指定框架的主版本的数字。

MinorNumber

一个指定框架的次要版本的数字。

ServiceNumber

一个指定框架服务的数字。

注解

UMDF 驱动程序提供指向 IWDFDriver：：IsVersionAvailable 方法的UMDF_VERSION_DATA结构的指针，以描述驱动程序支持的最低框架版本。

注意警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。
 

Microsoft_WDF_UMDF_Version 是 UMDF_VERSION_DATA 类型的全局变量，用于指定当前版本的框架的主版本、次要版本和服务编号。

例如，在 Windows 8 中，Wudfddi.h 指定：

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

使用 Wudfddi.h 编译驱动程序时， Microsoft_WDF_UMDF_Version 包含在驱动程序二进制文件中，并使用 __declspec (dllexport) 导出。

当系统加载驱动程序时，主机进程 (WUDFHost.exe) 验证驱动程序的主版本是否与框架的主版本匹配，以及驱动程序的次要版本是否小于或等于框架的次要版本。

除了使用 Wudfddi.h 进行生成之外，驱动程序不需要执行任何操作来向框架提供此版本号。

终止支持：在 UMDF 2.0 及更高版本中不可用。

最低 UMDF 版本：1.0

标头：Wudfddi.h (包括 Wudfddi.h)

要求

要求 值
Header wudfddi_types.h (包括 Wudfddi_types.h)

另请参阅

IWDFDriver：：IsVersionAvailable

Microsoft_WDF_UMDF_Version