Verwenden von Dirids

Viele Verzeichnisse, die in INF-Dateien angezeigt werden, können mithilfe von Verzeichnisbezeichnern (dirids) ausgedrückt werden. Dies sind Zahlen, die bestimmte Verzeichnisse identifizieren. Anwendungen können vom System definierte Verzeichnisse verwenden (aber nicht neu zuweisen), die mit dirids mit Werten zwischen -1 bis 32767 verbunden sind.

Um dirids mit benutzerdefinierten Werten von 32768 bis 65534 oder 65536 und höher zu erstellen, verwenden Sie die Funktion SetupSetDirectoryId (in der Microsoft Windows SDK-Dokumentation beschrieben).

Beachten Sie, dass eine dirid mit dem Wert 65535 als synonym mit der dirid mit dem Wert -1 betrachtet wird, auch wenn der letztere Wert (dirid -1) bevorzugt wird.

Wenn Sie dirids in Ihrer INF-Datei verwenden möchten, beachten Sie die folgenden beiden Richtlinien:

1. Wenn die Syntax für einen INF-Dateieintrag explizit einen dirid-Wert angibt (z. B. im Abschnitt INF DestinationDirs), muss dieser Wert als Zahl ausgedrückt werden.

   Im folgenden Beispiel wird diese Syntax gezeigt:

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

2. Wenn die Syntax für einen INF-Dateieintrag einen Dateipfad angibt, können Sie eine vom System bereitgestellte Zeichenfolgenersetzung verwenden, um einen Teil oder den gesamten Pfad darzustellen. Diese Ersetzung hat das folgende Format:

   %dirid%

   Dieses Format besteht aus einem Prozentzeichen (%), gefolgt von der dirid für das Verzeichnis, das Sie angeben möchten, gefolgt von einem weiteren Prozentzeichen (%). Ein umgekehrter Schrägstrich () am Ende trennt diesen Ausdruck von einem folgenden Dateinamen oder von zusätzlichen Verzeichnissen im Pfad.

   Im folgenden Beispiel wird diese Syntax gezeigt:

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

   Bei vollständiger Erweiterung ist der im vorherigen Beispiel gezeigte Pfad c:\windows\system32\drivers\aic78xx.sys (wenn Windows im Verzeichnis c:\windows installiert wurde). Beachten Sie, dass die Zeichenfolgenersetzung bzw. das Format %dirid%, überall verwendet werden kann, wo eine Zeichenfolge erwartet wird, ausgenommen im Abschnitt INF Strings der INF-Datei.

   Die beiden folgenden Beispiele zeigen, wie die Zeichenfolgenersetzung nicht verwendet werden sollte.

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

   Im ersten Beispiel erfordert die Syntax für den Eintrag DefaultDestDir eine Zahl als Wert. Der Ausdruck %11% wird jedoch zu einer Zeichenfolge erweitert. Im zweiten Beispiel beabsichtigte der INF-Schreibvorgang offenbar, den Wert für den Eintrag ServiceBinary auf eine Datei in dem Verzeichnis festzulegen, das Treiber enthält (siehe folgende Tabelle für weitere Informationen). Der Fehler tritt auf, da Windows nach der angegebenen Datei in einem Verzeichnis namens „12“ sucht, das wahrscheinlich nicht auf dem Computer vorhanden ist.

Die folgende Tabelle enthält mehrere häufig verwendete dirids und die Verzeichnisse, die sie darstellen. Die am häufigsten durch Geräte-INF-Dateien und Treiber-INF-Dateien angegebenen Werte sind am oberen Ende der Tabelle aufgelistet.

Im Rahmen der Anforderungen an die Treiberpaketisolation müssen Treiber aus dem Treiberspeicher ausgeführt werden und die DIRID 13 verwenden, um den Speicherort für Treiberpaketdateien bei der Installation anzugeben. Ab Windows 11, Version 24H2, sind einige der häufig verwendeten dirids veraltet, wenn Sie Ihre INF für eine WHQL-Signatur übermitteln. Weitere Informationen finden Sie unter InfVerif /h.

Dirid-Werte von 16384 bis 32767 sind für spezielle Shellordner reserviert. In der folgenden Tabelle werden die dirid-Werte für diese Ordner aufgelistet.

Zusätzlich zu den Werten in dieser Tabelle, die in Setupapi.h definiert sind, können Sie alle CSIDL_Xxx-Werte verwenden, die in Shlobj.h definiert sind. Um einen dirid-Wert für einen Ordner zu definieren, der nicht in dieser Tabelle aufgelistet ist, fügen Sie dem CSIDL_Xxx-Wert „16384 (0x4000)“ hinzu. Weitere Informationen zu CSIDL_Xxx-Werten finden Sie in der Windows SDK-Dokumentation.