Résolution des problèmes d’installation du pilote KMDF et UMDF

Le co-programme d’installation du framework crée des messages de débogage. Vous pouvez voir ces messages dans un débogueur.

En outre, le co-programme d’installation écrit ses messages de débogage dans le fichier journal des actions d’installation (%windir%\setupact.log). Le journal des actions d’installation contient la version du co-programme d’installation et le pilote spécifiés dans le fichier INF du pilote. Vous devez vérifier qu’ils sont comme prévu.

Examen de l’installation de KMDF

La sortie suivante dans le journal des actions d’installation provient de la réussite de l’installation d’un pilote KMDF :

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

Dans le scénario ci-dessus, aucune mise à jour n’était nécessaire, car la version sur disque et la version de l’infrastructure en mémoire sont KMDF 1.9, qui est la même version du co-programme d’installation.

Considérez la sortie suivante, qui détaille une installation infructueuse :

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

Dans ce scénario, une mise à jour et un redémarrage étaient nécessaires, car la version en mémoire et la version sur disque du runtime KMDF étaient antérieures à la version du co-programme d’installation. Toutefois, la mise à jour a échoué. Le co-programme d’installation pointe vers des fichiers journaux supplémentaires où vous pouvez trouver plus d’informations sur l’échec.

Vous pouvez également case activée le journal des événements système pour les erreurs liées à la liaison dynamique du pilote KMDF à la bibliothèque runtime. Une telle erreur peut générer une entrée Wdf<MajorVersionNumber><MinorVersionNumber> dans le journal des événements système. Dans ce cas, redémarrez l’ordinateur. Vous pouvez également forcer la réinstallation du runtime KMDF en supprimant le.sysWdf<MajorVersionNumber><MinorVersionNumber> du dossier %windir%\system32\drivers.

Examen de l’installation d’UMDF

La sortie suivante dans le journal des actions d’installation décrit une installation réussie du pilote UMDF.

WudfUpdate: installing version (1,9,0,7100).
WudfUpdate: Checking for presence of previous UMDF installation.
WudfUpdate: Found binary %WINDIR%\system32\drivers\wudfrd.sys version (1.9.0.7100)
WudfUpdate: Found binary %WINDIR%\system32\drivers\wudfpf.sys version (1.9.0.7100)
WudfUpdate: Found binary %WINDIR%\system32\wudfhost.exe version (1.9.0.7100)
WudfUpdate: Found binary %WINDIR%\system32\wudfsvc.dll version (1.9.0.7100)
WudfUpdate: Found binary %WINDIR%\system32\wudfx.dll version (1.9.0.7100)
WudfUpdate: Found binary %WINDIR%\system32\wudfplatform.dll version (1.9.0.7100)
WudfUpdate: Found binary %WINDIR%\system32\wudfcoinstaller.dll version (1.9.0.7100)
WudfUpdate: UMDF installation is same as update. WudfUpdate: Loading configuration coinstaller from D:\Windows\system32\wudfcoinstaller.dll.
WudfCoInstaller: ReadWdfSection: Checking WdfSection [Echo_Install.NT.Wdf]
WudfCoInstaller: Configuring UMDF Service  WUDFEchoDriver.
WudfCoInstaller: Service WudfSvc is already running.
WudfCoInstaller: Final status: error(0) The operation completed successfully.

Dans le scénario ci-dessus, aucune mise à jour n’est nécessaire, car la version sur disque du runtime est UMDF 1.9, qui est la même que la version du co-programme d’installation.

Considérez la sortie suivante, qui détaille une installation infructueuse.

WudfUpdate: installing version (1,9,0,7100).
WudfUpdate: Checking for presence of previous UMDF installation.
WudfUpdate: Found binary %WINDIR%\system32\drivers\wudfrd.sys version (1.5.0.6000)
WudfUpdate: Found binary %WINDIR%\system32\drivers\wudfpf.sys version (1.5.0.6000)
WudfUpdate: Found binary %WINDIR%\system32\wudfhost.exe version (1.5.0.6000)
WudfUpdate: Found binary %WINDIR%\system32\wudfsvc.dll version (1.5.0.6000)
WudfUpdate: Found binary %WINDIR%\system32\wudfx.dll version (1.5.0.6000)
WudfUpdate: Found binary %WINDIR%\system32\wudfplatform.dll version (1.5.0.6000)
WudfUpdate: Found binary %WINDIR%\system32\wudfcoinstaller.dll version (1.5.0.6000)
WudfUpdate: UMDF installation is older than current.
WudfUpdate: Locating resource stream WUDF_UPDATE_VISTA-RTM.
WudfUpdate: unpacking update from resource to Microsoft User-Mode Driver Framework Install-v1.9-Vista.msu.
WudfUpdate: Temporary path is D:\Windows\Temp\WDF7625.tmp.
WudfUpdate: Invoking update "%SYSTEMROOT%\system32\wusa.exe" with command line "D:\Windows\Temp\WDF7625.tmp\Microsoft User-Mode Driver Framework Install-v1.9-Vista.msu /quiet /norestart".
WudfUpdate: Waiting for update to terminate.
WudfUpdate: Update process returned 22.
WudfUpdate: update returned error 0x16 - error(22) The device does not recognize the command.
WudfUpdate: For additional information please look at the log files %windir%\windowsupdate.log and %windir%\Logs\CBS\CBS.log
WudfUpdate: Cleaning up update.
WudfUpdate: Error updating UMDF - error(22) The device does not recognize the command. Aborting installation.

Dans ce scénario, la version sur disque du runtime UMDF était antérieure à la version du co-programme d’installation. Toutefois, dans ce cas, la mise à jour a échoué. Le co-programme d’installation pointe vers des fichiers journaux supplémentaires où vous trouverez plus d’informations sur la raison de l’échec.