Używanie Dirids

Wiele katalogów, które pojawiają się w plikach INF, można wyrazić przy użyciu identyfikatorów katalogu (dirids), które są liczbami identyfikującymi określone katalogi. Aplikacje mogą korzystać z katalogów zdefiniowanych przez system, które są skojarzone z dirids, z których wartości są od -1 do 32767, ale nie mogą ich ponownie przypisać.

Aby utworzyć diridy z wartościami zdefiniowanymi przez użytkownika w zakresie od 32768 do 65534 oraz od 65536 wzwyż, użyj funkcji SetupSetDirectoryId (opisanej w dokumentacji Microsoft Windows SDK).

Należy pamiętać, że dirid o wartości 65535 jest uważany za synonim z dirid z wartością -1, chociaż ten ostatni (dirid -1) jest preferowany.

Jeśli zamierzasz używać dirids w pliku INF, rozważ następujące dwie wskazówki:

1. Gdy składnia wpisu pliku INF jawnie określa wartość (na przykład sekcja INF DestinationDirs, należy wyrazić ją jako liczbę.

   W poniższym przykładzie pokazano tę składnię:

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

2. Gdy składnia wpisu pliku INF określa ścieżkę pliku, można użyć systemowego podstawiania ciągów do reprezentowania części lub całej tej ścieżki. Podstawienie ma następującą formę:

   % dirid%

   Ten formularz składa się ze znaku procentu (%), po którym następuje dla katalogu, który chcesz określić, a następnie kolejny znak procentu (%). Znak ukośnika odwrotnego () oddziela to wyrażenie od następującej nazwy pliku lub dodatkowych katalogów w ścieżce.

   W poniższym przykładzie pokazano tę składnię:

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

   Po pełnym rozwinięciu ścieżka wyświetlana w poprzednim przykładzie staje się c:\windows\system32\drivers\aic78xx.sys (zakładając, że system Windows został zainstalowany w katalogu c:\windows). Należy pamiętać, że podstawianie ciągów lub forma %dirid% mogą być używane w dowolnym miejscu, gdzie oczekiwany jest ciąg, z wyjątkiem sekcji INF Strings pliku INF.

   W dwóch poniższych przykładach pokazano, jak podstawianie ciągów powinno nie być używane.

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

   W pierwszym przykładzie składnia dla wpisu DefaultDestDir wymaga, aby jego wartość była liczbą. Jednak wyrażenie %11% rozszerza się na ciąg. W drugim przykładzie autor INF najwyraźniej zamierzał ustawić wartość dla wpisu ServiceBinary na plik w katalogu zawierającym pliki sterowników (zobacz poniższą tabelę, aby uzyskać więcej informacji). Błąd występuje, ponieważ system Windows wyszukuje określony plik w katalogu o nazwie "12", który prawdopodobnie nie istnieje na komputerze.

Poniższa tabela zawiera kilka często używanych diridsoraz odpowiadające im katalogi. Wartości najczęściej określane przez pliki INF urządzenia i pliki INF sterownika są wyświetlane w górnej części tabeli.

W ramach wymagania izolacji pakietów sterowników należy uruchomić z magazynu sterowników i użyć DIRID 13, aby określić lokalizację plików pakietów sterowników podczas instalacji. Począwszy od systemu Windows 11, wersja 24H2 niektóre z powszechnie używanych zostały przestarzałe podczas przesyłania INF na podpis WHQL. Aby uzyskać więcej informacji, zobacz InfVerif /h.

wartości Dirid z zakresu od 16384 do 32767 są zarezerwowane dla specjalnych folderów systemowych. W poniższej tabeli przedstawiono wartości dirid dla tych folderów.

Oprócz wartości w tej tabeli zdefiniowanych w Setupapi.hmożna użyć dowolnych wartości CSIDL_Xxx zdefiniowanych w Shlobj.h. Aby zdefiniować wartość dirid dla folderu, który nie znajduje się w tej tabeli, dodaj wartość 16384 (0x4000) do wartości CSIDL_Xxx. Aby uzyskać więcej informacji na temat wartości CSIDL_xxx, zobacz dokumentację zestawu Windows SDK.