Delen via

DDI-gebruiksregelset (NDIS)

Gebruik deze regels om te controleren of uw stuurprogramma de NDIS-DDI's correct en op de juiste manier gebruikt.

In deze sectie

Onderwerp Beschrijving

Init_DeRegisterInterrupt

De Init_DeRegisterInterrupt-regel geeft aan dat als NdisMRegisterInterruptEx ten minste één keer wordt aangeroepen tijdens MPInitilize, NdisMDeregisterInterruptEx ten minste één keer in MPHaltEx moet worden aangeroepen.

Init_NdisAllocateIoWorkItem

De Init_NdisAllocateIoWorkItem-regel geeft aan dat als NdisAllocateIoWorkItem ten minste één keer wordt aangeroepen tijdens MiniportInitializeEx, de functie NdisFreeIoWorkItem moet:

Init_RegisterInterrupt

De Init_RegisterInterrupt regel geeft aan dat de registratie van interrupts, die meestal tijdens de initialisatie plaatsvindt, ongedaan moet worden gemaakt als er iets misgaat in het initialisatieproces of tijdens het stoppen van het minipoortstuurprogramma.

Als NdisMRegisterInterruptEx ten minste één keer wordt aangeroepen tijdens MiniportInitializeEx, moet de functie NdisMDeregisterInterruptEx ten minste één keer worden aangeroepen in MiniportHaltEx.

Init_RegisterSG

De Init_RegisterSG regel geeft aan dat de registratie van de SG (scatter-gather list), die meestal tijdens de initialisatie plaatsvindt, ongedaan moet worden gemaakt als er iets misgaat in het initialisatieproces of tijdens het stoppen van het minipoortstuurprogramma.

Als NdisMRegisterScatterGatherDma ten minste één keer wordt aangeroepen tijdens MiniportInitializeEx, moet de functie NdisMDeregisterScatterGatherDma ten minste één keer worden aangeroepen in MiniportHaltEx.

NdisFDeregisterFilterDriver

Een filterstuurprogramma moet NdisFDeregisterFilterDriver aanroepen vanuit de FilterDriverUnload-routine .

NdisMDeregisterInterruptEx

Nadat NdisMDeregisterInterruptEx het besturingselement retourneert, kan het minipoortstuurprogramma de functie NdisMSynchronizeWithInterruptEx niet aanroepen.

NullCheck

De NullCheck-regel controleert of een NULL-waarde in de stuurprogrammacode niet later in het stuurprogramma wordt gedereferentieerd. Deze regel meldt een defect als aan een van deze voorwaarden wordt voldaan:

  • Er is een toewijzing van NULL die later wordt gedereferentieerd.
  • Er is een globale parameter of procedureparameter in een stuurprogramma dat mogelijk NULL is en later wordt gedereferenceerd. Er is een expliciete controle in het stuurprogramma die suggereert dat de initiële waarde van de aanwijzer NULL kan zijn.

Met NullCheck-regelovertredingen worden de meest relevante code-instructies gemarkeerd in het traceervenster. Voor meer informatie over het werken met rapportuitvoer, zie het Static Driver Verifier-rapport en het begrijpen van de Trace Viewer.

De DDI-gebruiksregelset selecteren

  1. Selecteer uw stuurprogrammaproject (.vcxProj) in Microsoft Visual Studio. Klik in het Stuurprogramma menu op Statische stuurprogrammaverificatie starten….

  2. Klik op het tabblad Regels . Selecteer onder RegelsetsDDIUsage.

    Als u de standaardregelset wilt selecteren in een opdrachtpromptvenster van Visual Studio-ontwikkelaars, geeft u DDIUsage.sdv op met de optie /check . Voorbeeld:

    msbuild /t:sdv /p:Inputs="/check:DDIUsage.sdv" mydriver.VcxProj /p:Configuration="Win8 Release" /p:Platform=Win32

    Voor meer informatie, zie Static Driver Verifier gebruiken om defecten te vinden in stuurprogramma's en Static Driver Verifier-opdrachten (MSBuild).

  • Last updated on