A Dirids használata

Az INF-fájlokban megjelenő könyvtárak nagy része könyvtárazonosítók (dirids) használatával fejezhető ki, amelyek bizonyos könyvtárakat azonosító számok. Az alkalmazások használhatják, de nem rendelhetik újra a rendszer által definiált könyvtárakat, amelyek olyan dirids-ekhez vannak társítva, amelyek értékei -1 és 32767 között vannak.

Ha a 32768 és 65534 közötti vagy a 65536-os vagy újabb felhasználói értékekkel rendelkező dirideket szeretne létrehozni, használja a SetupSetDirectoryId függvényt (a Microsoft Windows SDK dokumentációjában leírtak szerint).

Vegye figyelembe, hogy a 65535 értékkel rendelkező dirid szinonimának minősül a -1 értékkel rendelkező dirid értékkel, bár az utóbbi (dirid -1) előnyben részesítendő.

Ha dirids szeretne használni az INF-fájlban, vegye figyelembe az alábbi két irányelvet:

  1. Ha egy INF-fájlbejegyzés szintaxisa explicit módon meghatároz egy dirid értéket (például az INF DestinationDirs szakaszban), akkor ezt az értéket számként kell megadni.

    Az alábbi példa ennek szintaxisát szemlélteti:

    [DestinationDirs]
    DefaultDestDir = 11  ;  \system32 directory on Windows 2000 and later versions
    
  2. Ha egy INF-fájlbejegyzés szintaxisa megadja a fájl elérési útját, a rendszer által biztosított sztring-helyettesítéssel az elérési út egy részét vagy egészét jelölheti. Ez a helyettesítés a következő formáját tartalmazza:

    % dirid%

    Ez a formátum egy százalék (%) karakterből áll, amelyet a megadni kívánt könyvtár dirid azonosítója, majd egy másik százalék (%) karakter követ. A záró fordított perjel () karakter elválasztja ezt a kifejezést a következő fájlnévtől vagy a következő további könyvtáraktól az elérési útban.

    Az alábbi példa ezt a szintaxist mutatja be:

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

    A teljes kibontáskor az előző példában látható elérési út a c:\windows\system32\drivers\aic78xx.sys lesz (feltéve, hogy a Windows a c:\windows könyvtárba lett telepítve). Vegye figyelembe, hogy a sztring helyettesítése vagy %dirid% alak bárhol használható, ahol egy sztring várható, kivéve az INF-fájl INF Strings szakaszának részét.

    Az alábbi két példa bemutatja, hogyan nem szabad sztringhelyettesítést használni.

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

    Az első példában a DefaultDestDir bejegyzés szintaxisa megköveteli, hogy az értékének számnak kell lennie. A %11% kifejezés azonban karakterlánccá bővül. A második példában az INF-író úgy tűnik, hogy a ServiceBinary bejegyzés értékét egy olyan fájlra kívánta beállítani a könyvtárban, amely illesztőprogramokat tartalmaz (további információkért tekintse meg az alábbi táblázatot). A hiba azért fordul elő, mert Windows a megadott fájlt egy "12" nevű könyvtárban keresi, amely valószínűleg nem létezik a számítógépen.

Az alábbi táblázat számos gyakran használt dirids és az általuk képviselt könyvtárakat mutatja be. Az eszköz INF-fájljai és az illesztőprogram INF-fájljai által leggyakrabban megadott értékek a táblázat tetején jelennek meg.

Az illesztőprogram-csomag elkülönítésére vonatkozó követelmények részeként az illesztőprogramnak Futtatás az illesztőprogram-tárolóból állapotban kell lennie, és a DIRID 13 használatával meg kell adnia a telepítéskor használt illesztőprogram-csomagfájlok helyét. A Windows 11 24H2-es verziójától kezdve a gyakran használt diridek némelyike elavult, amikor az INF-et WHQL-aláírásra nyújtja be. További információ: InfVerif /h.

Value Célkönyvtár Elavult kiadás

01

SourceDrive:\pathname (az a könyvtár, ahonnan az INF-fájlt telepítették)

Windows 11 24H2

10

Windows könyvtár.

Ez egyenértékű a %SystemRoot%.

11

Rendszerkönyvtár.

Ez egyenértékű a következővel: %SystemRoot%\system32 Windows 2000 és a Windows újabb verzióiban.

12

Illesztőprogramok könyvtára.

Ez egyenértékű a %SystemRoot%\system32\drivers mappával a Windows 2000 és a Windows későbbi verziói esetén.

13

Az illesztőprogram-csomag Illesztőprogram-tároló könyvtára.

A Windows 8.1 és újabb verziói esetében adja meg annak az illesztőprogram-tároló könyvtárnak az elérési útját, amelybe az illesztőprogram-csomagot importálták.

Ne használja a DelFiles-t olyan fájlhoz, amelynél a DestinationDirs tartalmazza a dirid 13 értéket.

A fájl SourceDiskFiles szakaszának választható alkönyvtárának meg kell egyeznie a DestinationDirs szakasz fájlra vonatkozó bejegyzésének alkönyvtárával.

Ne használja a CopyFiles elemet olyan fájl átnevezésére, amelyhez a DestinationDirs tartalmazza a dirid 13-at.

A dirid 13 használatával kapcsolatos további információkért lásd: Futtatás az illesztőprogram-tárolóból.

17

INF könyvtár

Windows 11 24H2

18

Súgókönyvtár

Windows 11 24H2

20

Betűtípusok könyvtár

Windows 11 24H2

21

Nézők könyvtára

Windows 11 24H2

23

Színkönyvtár (ICM) (nyomtatóillesztők telepítéséhez nem használható)

24

A rendszerlemez gyökérkönyvtára.

Ez annak a lemeznek a gyökérkönyvtára, amelyen a Windows-fájlok telepítve vannak. Ha például a 10 . dirid értéke "C:\winnt", akkor a 24. dirid értéke "C:\".

Windows 11 24H2

25

Megosztott könyvtár

Windows 11 24H2

30

A rendszerindító lemez gyökérkönyvtára, más néven "ARC rendszerpartíció". (Ez lehet, hogy ugyanaz a könyvtár, vagy nem, mint a dirid 24 által jelölt könyvtár.)

Windows 11 24H2

50

Rendszerkönyvtár

Ez egyenértékű a %SystemRoot%\\system elemmel.

Windows 11 24H2

51

Spool directory (nyomtatóillesztők telepítéséhez nem használatos – lásd Printer Dirids)

52

Spool illesztőprogramok könyvtára (nyomtatóillesztők telepítéséhez nem használható)

53

Felhasználói profil könyvtára

Windows 11 24H2

54

Könyvtár, ahol Ntldr.exe és Osloader.exe találhatók

Windows 11 24H2

55

Nyomtatóprocesszorok könyvtára (nyomtatóillesztők telepítéséhez nem használható)

-1

Abszolút elérési út

Windows 11 24H2

Az 16384 és 32767 közötti dirid értékek speciális rendszerhéjmappákhoz vannak fenntartva. Az alábbi táblázat ezeknek a mappáknak a dirid értékeit mutatja be.

Value A Shell speciális mappája Kiadás elavulttá tétele

16406

Minden felhasználó\Start menü

Windows 11 24H2

16407

Minden felhasználó\Start Menu\Programok

Windows 11 24H2

16408

Minden felhasználó\Start menü\Programok\Indítás

Windows 11 24H2

16409

All Users\Desktop

Windows 11 24H2

16415

Minden felhasználó\Kedvencek

Windows 11 24H2

16419

All Users\Alkalmazásadatok

Windows 11 24H2

16422

Programfájlok

16425

%SystemRoot%\SysWOW64

16426

%ProgramFiles(x86)%

16427

Program Files\Common

16428

%ProgramFiles(x86)%\Common

16429

Minden felhasználó\Sablonok

Windows 11 24H2

16430

All Users\Dokumentumok

Windows 11 24H2

Az ebben a táblázatban szereplő, a Setupapi.h-ban definiált értékek mellett a Shlobj.h-ban definiált CSIDL_Xxx értékek bármelyikét is használhatja. A táblázatban nem szereplő mappák dirid értékének meghatározásához adja hozzá az 16384-et (0x4000) a CSIDL_Xxx értékhez. A CSIDL_Xxx értékekkel kapcsolatos további információkért tekintse meg a Windows SDK dokumentációját.