Debugging Driver Installation
The framework's co-installer creates debugging messages. You can see these messages in a debugger if you are running a checked build of Windows.
Additionally, the co-installer writes its debugging messages to the Setup action log (%windir%\setupact.log) file. The Setup action log contains the version of the co-installer and the driver specified in the driver's INF file. You should verify that these are as expected. For example, the following output in the Setup action log describes a successful driver installation:
WdfCoInstaller: DIF_INSTALLDEVICE: Pre-Processing WdfCoInstaller: ReadComponents: WdfSection for Driver Service ECHO using KMDF lib version Major 0x1, minor 0x9 WdfCoInstaller: DIF_INSTALLDEVICE: Coinstaller version: 1.9.7100 WdfCoInstaller: DIF_INSTALLDEVICE: KMDF in-memory version: 1.9.7100 WdfCoInstaller: DIF_INSTALLDEVICE: KMDF on-disk version: 1.9.7100 WdfCoInstaller: Service Wdf01000 is running WdfCoInstaller: DIF_INSTALLDEVICE: Update is not required. The on-disk KMDF version is newer than or same as the version of the coinstaller WdfCoInstaller: DIF_INSTALLDEVICE: Post-Processing
In the above scenario, no update was necessary because the on-disk version and in-memory framework version is KMDF 1.9, which is the same version of the co-installer.
Consider the following output, which details an unsuccessful installation:
WdfCoInstaller: ReadComponents: WdfSection for Driver Service ECHO using KMDF lib version Major 0x1, minor 0x9 WdfCoInstaller: DIF_INSTALLDEVICE: Coinstaller version: 1.9.7100 WdfCoInstaller: DIF_INSTALLDEVICE: KMDF in-memory version: 1.7.6000 WdfCoInstaller: DIF_INSTALLDEVICE: KMDF on-disk version: 1.7.6000 WdfCoInstaller: Service Wdf01000 is running WdfCoInstaller: DIF_INSTALLDEVICE: Reboot is required, because the in-memory KMDF version is older than the coinstaller's version. WdfCoInstaller: DIF_INSTALLDEVICE: Update is required, because the on-disk KMDF version is older than the coinstaller WdfCoInstaller: VerifyMSRoot: exit: error(0) The operation completed successfully. WdfCoInstaller: Invoking "D:\Windows\system32\wusa.exe "D:\Windows\Temp\WdfTemp\Microsoft Kernel-Mode Driver Framework Install-v1.9-Vista.msu" /quiet /norestart". WdfCoInstaller: The update process returned error code :error(265) <no error text>. WdfCoInstaller: For additional information please look at the log files %windir%\windowsupdate.log and %windir%\Logs\CBS\CBS.log
In this scenario, both an update and a reboot were necessary because the in-memory version and the on-disk version of the KMDF runtime were older than the version of the co-installer. However, the update was unsuccessful. The co-installer points to additional log files where you can find more information about the failure.
You can also check the system event log for errors related to the dynamic binding of the KMDF driver to the runtime library. Such an error may generate an Wdf<MajorVersionNumber><MinorVersionNumber> entry in the system event log. In this case, reboot the computer. You can also force a reinstallation of the KMDF runtime by deleting Wdf<MajorVersionNumber><MinorVersionNumber>.sys from the %windir%\system32\drivers folder.
Send comments about this topic to Microsoft
Build date: 4/5/2012
