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 结构的指针。
返回值
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