WdfDriverIsVersionAvailable 函数 (wdfdriver.h)

  • 项目

[适用于 KMDF 和 UMDF]

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

语法

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

参数

[in] Driver

驱动程序框架驱动程序对象的句柄，该驱动程序是从先前调用 WdfDriverCreate 或 WdfGetDriver 获取的。

[in] VersionAvailableParams

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

返回值

如果驱动程序运行的是 VersionAvailableParams 参数指定的库版本，则 WdfDriverIsVersionAvailable 返回 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)
Library 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