VS2013 wdk8.1 新建驱动项目,生成时报如下错误
错误 1 error -2: "Inf2Cat, signability test failed." Double click to see the tool output. E:HelloWDMHelloWDM PackageWin7Debuginf2catOutput.log 1 1 HelloWDM Package
解决方案没有找到,但是可以生成驱动,有谁知道原因?
VS2012趣事:时区和时间戳
引用注明>> 【作者:张佩】【原文:www.yiiyee.cn/blog】
前几天某个早晨,大概5点钟我就醒在床上,怎么也睡不着。想到手头还有一个驱动需要debug,就立刻发现了人生目标一样地爬了起来。匆匆洗漱完毕后,打开电脑,打开VS2012驱动项目。先把代码逻辑仔细的看过一遍,有了一点小发现,改了几行代码。按下F7开始编译。
编译结束后,很惊讶地发现“输出”试图中报了一个错误,是driver package工程报错。这里要说一下 相关的背景,通过VS2012的工程向导创建的驱动项目(solution)总是包含两个工程(project):一个是驱动工程,所有的源代码都在此, 编译后生成驱动文件(一般是.sys文件);一个是driver package工程,无源码,它的编译过程乃针对inf文件和sys文件进行处理,产生一个可安装的驱动包(driver package)。
头一次遇到package工程失败的情况,会是什么原因呢?
1>------ 已启动生成: 项目: Test Package, 配置: Win7 Debug x64 ------ 1> ....................... 1> Signability test failed. 1> 1> Errors: 1> 22.9.7: DriverVer set to incorrect date (postdated DriverVer not allowed) in Test.inf. The current date (UTC) is 1/7/2014. 1> 1> Warnings: 1> None 1>x64Win7Debuginf2catOutput.log : Inf2Cat error -2: "Inf2Cat, signability test failed." Double click to see the tool output. ========== 生成: 成功 0 个,失败 1 个,最新 1 个,跳过 0 个 ==========
Package工程
Package工程在生成可安装驱动安装包的过程中,会调用三个工具,为相关的文件进行数字签名:Stampinf.exe/ testsign.exe /inf2cat.exe。下面对这三个工具作一一介绍。
时间戳工具(Stampinf)
Stampinf.exe用来为inf文件生成时间戳和版本号。这个时间戳对应于inf文件中的DriverVer值,下面是一个示例:
[version] DriverVer=01/10/2014,1.0.0.0 ; time stamp(时间戳)+ version(版本号)
StampInf.exe工具可以在WDK安装包中找到,针对不同的硬件平台有不同的版本,x86版本的相对路径是:binx86staminf.exe。我们可以在控制台环境中运行此工具,以观察它的使用方法。
C:Usersmozhang>stampinf.exe #输出内容有所删减和整理 USAGE: stampinf -f filename [-s section] [-d <xx/yy/zzzz> | *] -a architecture -n [-c catalogfile] [-v | *] [-k nnnnn] [-u nnnnn] [-i path]
-f:指定inf文件的路径
-a:指定硬件平台,可使用x86或AMD64二者之一。如果你指定的inf文件中含有关键字$ARCH$,stampinf会自动把它们都替换成指定的x86或AMD64值。这种情况下,inf文件中的“NT$ARCH$”最终会变成”NTx86“或”NTAMD64“。如果inf文件中包含了关键字$ARCH$,但没有指定-a参数,stampinf会自动删除所有的关键字。这种情况下,inf文件中的“NT$ARCH$”最终会变成”NT“。
-d:指定具体的时间戳。如果指定为“*”,Stampinf会以当前时间来设置。这个选项可选,默认使用当前时间。
-v:指定版本信息,比如可以指定为:1.0.0.0。但如果指定的值为“*”,则表示使用“时.分.秒.毫秒”的形式来设置版本号。这个选项可选,默认使用“时.分.秒.毫秒”方式。
-k/-u:这两个值用来指定KMDF和UMDF的版本,可用指定的值替换inf文件中KMDF的关键字$KMDFVERSION$和$KMDFCOINSTALLERVERSION$,以及UMDF的关键字$UMDFVERSION$和$UMDFCOINSTALLERVERSION$。
下面是一个例子,我在控制台中执行命令为cy001.inf文件打时间戳:
C:Usersmozhang>"stampinf.exe" -f "c:cy001.inf" -d "*" -v "1.0.0.0" Stamping c:cy001.inf [Version] section with DriverVer=01/10/2014,1.0.0.0
打开cy001.inf文件查看:
DriverVer=01/10/2014,1.0.0.0
如果把-v的参数换成”*”:
C:Usersmozhang>"stampinf.exe" -f "c:cy001.inf" -d "*" -v "*" Stamping c:cy001.inf [Version] section with DriverVer=01/10/2014,11.24.18.11
打开cy001.inf文件查看:
DriverVer=01/10/2014,11.24.18.11
打开Package工程的属性页,查看stampinf这一项的属性,能看到它默认使用的参数如下:
-k “1.11” -d ”*” –a “amd64” –u “1.11.0” –v “*”
它使用当前时间设置时间戳,用时.分.秒.毫秒的格式设置版本号。
TestSign
关于签名工具TestSign.exe,我曾在介绍64Signer的时候有过介绍。它使用指定的数字证书,给指定的镜像文件进行数字签名。参考64Signer的说明文档。
Inf2Cat
此工具用来生成cat文件。VS2012先把驱动安装有关的所以文件都拷贝到一个目录中,然后调用inf2cat.exe来生成cat文件。这些必 须被拷贝的文件包括:.inf文件,.sys文件,其它文件包括WDF框架的co-installer文件等。Inf文件所在的位置代表了driver package的位置。
为了试验,我把test.inf、test.sys、WdfCoInstaller01011.dll这三个文件手动拷贝到E:Test目录下面,然后调用inf2cat命令:
C:Usersmozhang>Inf2Cat.exe driver:"E: est" /os:"7_x86"
.......................
Signability test complete.
Errors:
None
Warnings:
None
Catalog generation complete.
E: est est.cat
参数中,/Driver:path指定了driver package的目录,亦即inf文件所在目录;/OS:指定了目标系统。最后生成了test.cat文件。
可以把Inf2Cat的工作分成三步:分析inf文件,收集信息;验证驱动包,包括验证时间戳、验证文件完整性;生成cat文件。
验证时间戳就是把inf文件DriverVer值和当前时间进行比较,看是否匹配。我在文章开始遇到的错误,正是时间戳验证失败导致的。验证文件完 整就是确保inf文件中涉及的所有文件都能在Driver Package目录中找到。比如用WDF框架编写的驱动,Driver Package中必须有WDF的co-installer文件。
时间戳验证
回到开头的错误,再把重要的错误信息列举如下:
DriverVer set to incorrect date (postdated DriverVer not allowed) in est.inf. The current date (UTC) is 1/7/2014.
Inf2Cat error -2: "Inf2Cat, signability test failed."
是inf2cat工具在执行的时候发生了错误,错误原因看上去是时间戳验证失败了。第一行告诉我,从DriverVer中拿到的时间不对,当前的UTC时间是1/7/2014。我特地看了一下电脑的当前时间并截了一幅图。我的当前时间是北京时间1月8号上午7点,和inf文件中DriverVer的值相同:
北京时间要比UTC标准时间提前8个小时,所以北京时间的8号凌晨7点钟,对应UTC时间的7号晚上11点。所以Inf2Cat使用的UTC时间正好和Inf文件中的Local时间差一天。这正是时间戳验证失败的原因所在(可以推测,inf2cat是只验证日期而不验证时分秒的,这才使得我只有在凌晨8点以前编译驱动,才有机会“碰巧”遇到这个错误)。
解决问题
解决问题的方法非常简单,只要让Inf2Cat验证的时候使用local时间就可以了。打开package工程的属性,在inf2cat工具的属性中进行设置。