Delen via

Een stuurprogrammapakket testen (handmatige implementatie)

In dit artikel wordt uitgelegd hoe u het INF-bestand voor de installatie van stuurprogramma's gebruikt om handmatig een stuurprogrammapakket op een testcomputer te installeren en de installatie en bewerking ervan te controleren.

Vereiste voorwaarden

  • Een stuurprogrammapakket dat klaar is om te installeren. U moet eerst uw stuurprogramma maken en bouwen en vervolgens een stuurprogrammapakket maken voor installatie. Zie Een stuurprogramma bouwen en een stuurprogrammapakket maken voor meer informatie.
  • Een doel-pc, geconfigureerd om het testondertekende stuurprogramma te accepteren.
  • Eventueel een geïnstalleerd foutopsporingsprogramma om het zojuist geïnstalleerde stuurprogramma te onderzoeken.

Overzicht

De computer waarop u het stuurprogramma installeert, wordt de doelcomputer of de testcomputergenoemd. Deze computer staat doorgaans los van de computer waarop u het stuurprogrammapakket ontwikkelt en bouwt. De computer waarop u het stuurprogramma ontwikkelt en bouwt, wordt de hostcomputergenoemd.

Het proces voor het verplaatsen van het stuurprogrammapakket naar de doelcomputer en het installeren van het stuurprogramma wordt het implementeren van het stuurprogramma genoemd.

Zoek de build-uitvoer voor het stuurprogramma

  1. Ga in Verkenner naar de map met de uitgepakte bestanden voor het voorbeeld. Ga bijvoorbeeld naar C:\DriverSamples\general\echo\kmdf voor het voorbeeldstuurprogramma voor echo. Binnen die map is de locatie van de gecompileerde stuurprogrammabestanden afhankelijk van de configuratie- en platforminstellingen die u in Configuration Manager hebt geselecteerd. Als u de standaardinstellingen ongewijzigd hebt gelaten, worden de gecompileerde stuurprogrammabestanden opgeslagen in een map met de naam \x64\Debug voor een 64-bits foutopsporingsbuild.

    De map moet deze bestanden bevatten:

    Bestand Beschrijving
    Echo.sys Het binaire systeembestand van het stuurprogramma.
    Echo.inf Een informatiebestand (INF) dat informatie bevat die nodig is om het stuurprogramma te installeren.
    Echo.cer Een .cer certificaatbestand dat is gegenereerd toen het stuurprogramma werd getest.
    Echo.pdb De optionele foutopsporingssymbolen voor het stuurprogramma voor gebruik met het Windows-foutopsporingsprogramma.

  2. Zoek een USB-duimstation of stel een netwerkshare in om de ingebouwde stuurprogrammabestanden van de host naar het doeltestsysteem te kopiëren.

  3. Kopieer de bestanden naar het doelsysteem om het stuurprogramma te installeren en te testen.

Het voorbeeld van het stuurprogramma installeren op het doelsysteem

Voer de volgende stappen uit om het stuurprogramma op het doelsysteem te installeren.

Belangrijk

Voordat u opstartinstellingen wijzigt, moet u mogelijk de Beveiligingsfuncties van Windows tijdelijk onderbreken, zoals BitLocker en Beveiligd opstarten op de test-pc. Schakel deze beveiligingsfuncties opnieuw in wanneer het testen is voltooid en beheer de test-pc op de juiste manier wanneer de beveiligingsfuncties zijn uitgeschakeld.

Het afdwingen van stuurprogrammahandtekeningen op het doelsysteem uitschakelen

Voordat u een ondertekend teststuurprogramma implementeert, bereidt u de doelcomputer voor door testondertekening in te schakelen.

Schakel op het doelsysteem testondertekende stuurprogramma's in:

  1. Open Windows-instellingen.

  2. Ga naar Systeem en selecteer Herstel.

  3. Onder Geavanceerde opstart, selecteer Nu opnieuw opstarten.

  4. Wanneer de computer opnieuw wordt opgestart, selecteert u Opstartopties. Selecteer in Windows 10 Problemen oplossen>Geavanceerde opties>opstartinstellingen en selecteer vervolgens opnieuw opstarten.

  5. Selecteer in het scherm Opstartinstellingen de optie Handtekening afdwingen van stuurprogramma uitschakelen door op de F7-toets te drukken.

  6. Start de doelcomputer opnieuw op.

Het testcertificaat installeren

Selecteer en houd op de doelcomputer het certificaatbestand ingedrukt of klik er met de rechtermuisknop op en selecteer Installerenen volg de aanwijzingen om het testcertificaat te installeren.

Zie Een computer voorbereiden voor handmatige implementatie van stuurprogramma'sals u meer gedetailleerde instructies nodig hebt voor het instellen van de doelcomputer.

Installatieoptie 1 - Klik met de rechtermuisknop op INF-bestand

In de volgende instructies ziet u hoe u het voorbeeldstuurprogramma installeert en test.

Open op de doelcomputer een opdrachtpromptvenster als administrator. Navigeer naar de map van het stuurprogrammapakket, klik met de rechtermuisknop op het INF-bestand, bijvoorbeeld echo.inf-bestand en selecteer Installeren.

Er wordt een dialoogvenster weergegeven dat aangeeft dat het teststuurprogramma een niet-ondertekend stuurprogramma is. Selecteer Dit stuurprogramma toch installeren om door te gaan.

Schermopname van windows-beveiligingswaarschuwing waarin staat dat Windows de uitgever van stuurprogrammasoftware niet kan verifiëren.

Installatieoptie 2 - Devcon-hulpprogramma

Er kunnen situaties zijn waarin het gebruik van een opdrachtregelprogramma, zoals PnPUtil of Devcon , handig kan zijn voor een werkstroom voor het ontwikkelen van stuurprogramma's. In deze sectie wordt beschreven hoe u het DevCon-hulpprogramma gebruikt om het stuurprogramma te installeren.

Ga op het hostsysteem naar de map Tools in uw WDK-installatie en zoek het DevCon-hulpprogramma. Zoek bijvoorbeeld in de volgende map: C:\Program Files (x86)\Windows Kits\10\Tools\x64\devcon.exe.

Maak een map op de doellocatie voor het gebouwde stuurprogrammapakket, bijvoorbeeld C:\EchoDriver. Kopieer devcon.exe naar het doelsysteem.

De volgende instructies laten zien hoe u het voorbeeldstuurprogramma installeert en test met behulp van devcon. Hier volgt de algemene syntaxis voor het devcon-hulpprogramma dat u gebruikt om het stuurprogramma te installeren:

devcon install <INF file> <hardware ID>

In dit voorbeeld is de echodriver geïnstalleerd. Het INF-bestand dat is vereist voor het installeren van dit stuurprogramma, is echo.inf. Het inf-bestand bevat de hardware-id voor het installeren van de echo.sys. Voor het echovoorbeeld is de hardware-id root\ECHO.

Open op de doelcomputer een opdrachtpromptvenster als administrator. Ga naar de map voor het stuurprogrammapakket en voer de volgende opdracht in:

devcon install echo.inf root\ECHO

Als u een foutbericht krijgt waarin staat dat devcon niet wordt herkend, probeer dan het pad toe te voegen aan het devcon hulpprogramma. Als u deze bijvoorbeeld hebt gekopieerd naar een map met de naam C:\Tools, gebruikt u de volgende opdracht:

c:\tools\devcon install echo.inf root\ECHO

Er wordt een dialoogvenster weergegeven dat aangeeft dat het teststuurprogramma een niet-ondertekend stuurprogramma is. Selecteer Dit stuurprogramma toch installeren om door te gaan.

Schermopname van windows-beveiligingswaarschuwing waarin staat dat Windows de uitgever van stuurprogrammasoftware niet kan verifiëren.

Aanbeveling

Als u problemen ondervindt met de installatie, controleert u het volgende bestand voor meer informatie. %windir%\inf\setupapi.dev.log

Het geïnstalleerde stuurprogramma controleren

Apparaatbeheer

Gebruik Apparaatbeheer om te bevestigen dat u het stuurprogramma hebt geïnstalleerd en dat het stuurprogramma is geladen en wordt uitgevoerd.

  1. Voer op de doelcomputer in een opdrachtpromptvenster de opdracht devmgmt in om Apparaatbeheer te openen.

  2. Kies in Apparaatbeheer in het menu Beeld de optie Apparaten per type.

  3. In de apparaatboom, zoek uw stuurprogramma, bijvoorbeeld WDF Echo-voorbeeldstuurprogramma in het knooppunt Voorbeeldapparaat.

Schermopname van de apparaatbeheerstructuur waarbij het voorbeeld van het WDF-echostuurprogramma wordt gemarkeerd.

PnPUtil

Gebruik PnPUtil om aanvullende informatie te verzamelen over het geïnstalleerde stuurprogramma.

  1. Open een opdrachtpromptvenster (Als administrator uitvoeren).

  2. Typ pnputil /? om opdrachtopties weer te geven. Zie de opdrachtsyntaxis van PnPUtil voor meer informatie.

  3. Gebruik de lijst pnputil /enum-drivers /files om alle OEM-stuurprogrammabestanden weer te geven.

  4. Gebruik de pnputil /enum-devices /problem /deviceids app om de apparaat-id's weer te geven voor apparaten met problemen. In dit voorbeeld wordt het stuurprogramma voor het OSR FX2-bord uitgevoerd met een actief probleemcode van CM_PROB_UNSIGNED_DRIVER.

PS C:\WINDOWS\system32> pnputil /enum-devices /problem /deviceids
Microsoft PnP Utility

Instance ID:                USB\VID_0547&PID_1002\5&353525f&0&3
Device Description:         WDF Sample Driver (DMF Sample 1) for OSR USB-FX2 Learning Kit
Class Name:                 Sample
Class GUID:                 {78a1c341-4539-11d3-b88d-00c04fad5171}
Manufacturer Name:          OSR
Status:                     Problem
Problem Code:               52 (0x34) [CM_PROB_UNSIGNED_DRIVER]
Problem Status:             0xC0000428
Driver Name:                oem40.inf
Hardware IDs:               USB\VID_0547&PID_1002&REV_0000
                            USB\VID_0547&PID_1002
Compatible IDs:             USB\COMPAT_VID_0547&Class_FF&SubClass_00&Prot_00
                            USB\COMPAT_VID_0547&Class_FF&SubClass_00
                            USB\COMPAT_VID_0547&Class_FF
                            USB\Class_FF&SubClass_00&Prot_00
                            USB\Class_FF&SubClass_00
                            USB\Class_FF

Zie PnPUtil-voorbeelden voor aanvullende opdrachten.

Voeg eventueel een foutopsporingsprogramma toe om het zojuist geïnstalleerde stuurprogramma te onderzoeken

Gebruik het Windows-kernelfoutopsporingsprogramma WinDbg om aan het stuurprogramma te koppelen en de bewerking ervan te controleren. Zie Aan de slag met Windows-foutopsporing voor meer informatie. Zie KDNET-netwerkfoutopsporing automatisch instellen voor informatie over het configureren van een doelcomputer en het instellen van een foutopsporingskabel met behulp van een netwerkverbinding

Aanbeveling

Verwijder het stuurprogramma en gebruik vervolgens de kernelfoutopsporingsprogrammaopdracht .kdfiles (Set Driver Replacement Map) om te kopiëren naar nieuwere versies van het stuurprogramma voor verdere tests.