Uso di Dirids

Molte delle directory visualizzate nei file INF possono essere espresse usando identificatori di directory (dirids), ovvero numeri che identificano directory specifiche. Le applicazioni possono usare, ma non possono riassegnare le directory definite dal sistema associate a diridi i cui valori sono compresi tra -1 e 32767.

Per creare diridi con valori definiti dall'utente compresi tra 32768 e 65534 o 65536 e versioni seguenti, usare la funzione SetupSetDirectoryId (descritta nella documentazione di Microsoft Windows SDK).

Tenere presente che un dirid con valore 65535 è considerato sinonimo di un dirid con un valore -1, anche se quest'ultimo (dirid -1) è preferibile.

Se si prevede di usare dirid nel file INF, prendere in considerazione le due linee guida seguenti:

1. Quando la sintassi per una voce di file INF specifica in modo esplicito un valore dirid (la sezione INF DestinationDirs, ad esempio), esprimere tale valore come numero.

   L'esempio seguente illustra questa sintassi:

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

2. Quando la sintassi per una voce di file INF specifica un percorso di file, è possibile usare una sostituzione di stringa fornita dal sistema per rappresentare parte o tutto questo percorso. Questa sostituzione ha il formato seguente:

   %dirid%

   Questo formato è costituito da un carattere percentuale (%) seguito dal dirid per la directory che si desidera specificare, seguito da un altro carattere percentuale (%) . Un carattere barra rovesciata di terminazione () separa questa espressione da un nome di file o da altre directory nel percorso.

   L'esempio seguente illustra questa sintassi:

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

   Quando completamente espanso, il percorso illustrato nell'esempio precedente diventa c:\windows\system32\driver\aic78xx.sys (presupponendo che Windows sia stato installato nella directory c:\windows). Tenere presente che la sostituzione di stringhe, o %dirid%, può essere utilizzata ovunque sia prevista una stringa, ad eccezione della sezione Stringhe INF del file INF.

   I due esempi seguenti illustrano come non usare la sostituzione di stringhe.

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

   Nel primo esempio, la sintassi per la voce DefaultDestDir richiede che il valore sia un numero. Tuttavia, l'espressione %11% si espande in una stringa. Nel secondo esempio, il writer INF apparentemente intende impostare il valore per la voce ServiceBinary su un file nella directory che contiene driver (vedere la tabella seguente per altre informazioni). L'errore si verifica perché Windows cerca il file specificato in una directory denominata "12", che probabilmente non esiste nel computer.

Nella tabella seguente vengono illustrati diversi dirid di uso comune e le directory che rappresentano. I valori specificati più comunemente dai file INF del dispositivo e dai file INF del driver sono elencati nella parte superiore della tabella.

Come parte dei requisiti di isolamento del pacchetto driver, un driver deve essere Eseguito dall'archivio driver e usare DIRID 13 per specificare il percorso per i file del pacchetto driver durante l'installazione. A partire da Windows 11, versione 24H2, alcuni dei dirid comunemente usati sono stati deprecati quando si invia INF per una firma WHQL. Per altre informazioni, vedere InfVerif /h.

I valori dirid compresi tra 16384 e 32767 sono riservati per cartelle speciali della shell. Nella tabella seguente vengono illustrati i valori dirid per queste cartelle.

Oltre ai valori di questa tabella definiti in Setupapi.h, è possibile usare uno dei valori CSIDL_Xxx definiti in Shlobj.h. Per definire un valore dirid per una cartella non elencata in questa tabella, aggiungere 16384 (0x4000) al valore CSIDL_Xxx . Per altre informazioni sui valori CSIDL_Xxx , vedere la documentazione di Windows SDK.