WdfDriverIsVersionAvailable 函数 (wdfdriver.h)

[适用于 KMDF 和 UMDF]

WdfDriverIsVersionAvailable 方法返回一个布尔值,该值指示驱动程序是否使用指定版本的 Kernel-Mode Driver Framework 库运行。

语法

BOOLEAN WdfDriverIsVersionAvailable(
  [in] WDFDRIVER                            Driver,
  [in] PWDF_DRIVER_VERSION_AVAILABLE_PARAMS VersionAvailableParams
);

参数

[in] Driver

驱动程序的框架驱动程序对象的句柄,该驱动程序从先前调用 WdfDriverCreateWdfGetDriver获取。

[in] VersionAvailableParams

指向标识框架库版本的 WDF_DRIVER_VERSION_AVAILABLE_PARAMS 结构的指针。

返回值

WdfDriverIsVersionAvailable 如果驱动程序与 VersionAvailableParams 参数指定的库版本一起运行,TRUE

如果驱动程序未使用指定的库版本运行,或者WDF_DRIVER_VERSION_AVAILABLE_PARAMS结构无效,该方法将返回 FALSE

如果 驱动程序 句柄无效,则会发生系统 bug 检查。

注解

有关库版本的详细信息,请参阅 框架库版本控制

例子

下面的代码示例报告错误(如果检测到意外的库版本号)。

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

WDF_DRIVER_VERSION_AVAILABLE_PARAMS_INIT(&ver, 1, 0);
if (!WdfDriverIsVersionAvailable(
                                 driver,
                                 &ver
                                 )) {
    DbgPrint("Unexpected library version.\n");
}

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfdriver.h (包括 Wdf.h)
图书馆 Wdf01000.sys(KMDF):WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI 符合性规则 DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf)

另请参阅

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver