Dirids gebruiken

Veel van de mappen die in INF-bestanden worden weergegeven, kunnen worden uitgedrukt met behulp van map-id's (diriden), die getallen zijn die specifieke mappen identificeren. Toepassingen kunnen de systeem gedefinieerde mappen die zijn gekoppeld aan dirids waarvan de waarden variëren van -1 tot en met 32767 gebruiken, maar kunnen deze niet opnieuw toewijzen.

Als u diriden wilt maken met door de gebruiker gedefinieerde waarden van 32768 tot en met 65534 of 65536 en hoger, gebruikt u de functie SetupSetDirectoryId (beschreven in de Microsoft Windows SDK-documentatie).

Houd er rekening mee dat een dorid met een waarde van 65535 wordt beschouwd als synoniem voor een dorid met een waarde van -1, hoewel de laatste (dirid -1) de voorkeur heeft.

Als u van plan bent dirids in uw INF-bestand te gebruiken, moet u rekening houden met de volgende twee richtlijnen.

1. Wanneer de syntaxis voor een INF-bestandsvermelding expliciet een dirid-waarde (bijvoorbeeld de sectie INF DestinationDirs) aangeeft, wordt die waarde als een getal weergegeven.

   In het volgende voorbeeld ziet u deze syntaxis:

   [DestinationDirs]
   DefaultDestDir = 11  ;  \system32 directory on Windows 2000 and later versions
   

2. Wanneer de syntaxis voor een INF-bestandsvermelding een bestandspad opgeeft, kunt u een door het systeem geleverde tekenreeks vervangen om een deel of al dit pad weer te geven. Deze vervanging heeft de volgende vorm:

   % dirid%

   Dit formaat bestaat uit een procentteken (%), gevolgd door het dirid voor de map die u wilt specificeren, gevolgd door een ander procentteken (%). Een afsluitend backslashteken () scheidt deze expressie van een volgende bestandsnaam of extra mappen in het pad.

   In het volgende voorbeeld ziet u deze syntaxis:

   [aic78xx_Service_Inst]
   ServiceBinary = %12%\aic78xx.sys
   

   Wanneer het pad in het vorige voorbeeld volledig is uitgevouwen, wordt c:\windows\system32\drivers\aic78xx.sys (ervan uitgaande dat Windows is geïnstalleerd in de c:\windows-directory). Houd er rekening mee dat de tekenreeksvervanging, of %dirid% formulier, overal kan worden gebruikt waar een tekenreeks wordt verwacht, met uitzondering van de sectie INF-tekenreeksen van het INF-bestand.

   In de twee volgende voorbeelden ziet u hoe tekenreeksvervanging niet mag worden gebruikt.

   [DestinationDirs]
   DefaultDestDir = %11%  ; Error! - number expected
   
   [aic78xx_Service_Inst]
   ServiceBinary = 12\aic78xx.sys  ; Error! - unknown directory name
   

   In het eerste voorbeeld vereist de syntaxis voor de vermelding DefaultDestDir dat de waarde een getal is. De %11%-expressie wordt echter uitgebreid naar een tekenreeks. In het tweede voorbeeld was de INF-schrijver blijkbaar van plan om de waarde voor de ServiceBinary-vermelding in te stellen op een bestand in de map die stuurprogramma's bevat (zie de volgende tabel voor meer informatie). De fout treedt op omdat Windows zoekt naar het opgegeven bestand in een map met de naam 12, die waarschijnlijk niet bestaat op de computer.

In de volgende tabel ziet u verschillende veelgebruikte diriden en de mappen die ze vertegenwoordigen. De waarden die het meest worden opgegeven door INF-bestanden van het apparaat en stuurprogramma-INF-bestanden, worden boven aan de tabel weergegeven.

Als onderdeel van de vereisten voor stuurprogrammapakketisolatie moet een stuurprogramma worden uitgevoerd vanuit de Driver Store en DIRID 13 gebruiken om de locatie op te geven voor stuurprogrammapakketbestanden op de installatie. Vanaf Windows 11, versie 24H2, zijn sommige veelgebruikte dirids verouderd verklaard bij het indienen van uw INF voor een WHQL-handtekening. Zie InfVerif /h voor meer informatie.

Dirid-waarden van 16384 tot en met 32767 zijn gereserveerd voor speciale shellmappen. In de volgende tabel ziet u dirid-waarden voor deze mappen.

Naast de waarden in deze tabel die zijn gedefinieerd in Setupapi.h, kunt u een van de CSIDL_Xxx-waarden gebruiken die zijn gedefinieerd in Shlobj.h. Als u een dirid-waarde wilt definiëren voor een map die niet in deze tabel wordt vermeld, voegt u 16384 (0x4000) toe aan de CSIDL_Xxx-waarde . Zie de Windows SDK-documentatie voor meer informatie over CSIDL_Xxx-waarden .