Utilisation de Dirids

La plupart des répertoires qui apparaissent dans les fichiers INF peuvent être exprimés à l’aide d’identificateurs de répertoire (dirids), qui sont des nombres qui identifient des répertoires spécifiques. Les applications peuvent utiliser, mais ne peuvent pas réaffecter les répertoires définis par le système associés à des dirids dont les valeurs sont comprises entre -1 et 32767.

Pour créer des dirids avec des valeurs définies par l’utilisateur de 32768 à 65534 ou 65536 et ultérieures, utilisez la fonction SetupSetDirectoryId (décrite dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows).

Sachez qu’un dirid avec une valeur de 65535 est considéré comme synonyme d’un dirid avec une valeur de -1, bien que ce dernier (dirid -1) soit préféré.

Si vous envisagez d’utiliser des dirids dans votre fichier INF, tenez compte des deux instructions suivantes :

1. Lorsque la syntaxe d’une entrée de fichier INF spécifie explicitement une valeur dirid (section INF DestinationDirs, par exemple), exprimez cette valeur en tant que nombre.

   L’exemple suivant illustre cette syntaxe :

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

2. Lorsque la syntaxe d’une entrée de fichier INF spécifie un chemin d’accès de fichier, vous pouvez utiliser une substitution de chaîne fournie par le système pour représenter une partie ou tout ce chemin d’accès. Cette substitution a la forme suivante :

   %dirid%

   Ce formulaire se compose d’un caractère de pourcentage (%), suivi du dirid pour le répertoire que vous souhaitez spécifier, suivi d’un autre caractère de pourcentage (%). Un caractère de barre oblique inverse (\) de fin sépare cette expression d’un nom de fichier ou des répertoires supplémentaires suivants dans le chemin d’accès.

   L’exemple suivant illustre cette syntaxe :

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

   Lorsqu’il est entièrement développé, le chemin indiqué dans l’exemple précédent devient c:\windows\system32\drivers\aic78xx.sys (en supposant que Windows a été installé dans le répertoire c:\windows). N’oubliez pas que la substitution de chaîne, ou formulaire %dirid%, peut être utilisée n’importe où où une chaîne est attendue, à l’exception de la section de chaînes INF du fichier INF.

   Les deux exemples suivants montrent comment la substitution de chaîne ne doit pas être utilisée.

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

   Dans le premier exemple, la syntaxe de l’entrée DefaultDestDir nécessite que sa valeur soit un nombre. Toutefois, l’expression %11% se développe sur une chaîne. Dans le deuxième exemple, l’enregistreur INF semble destiné à définir la valeur de l’entrée ServiceBinary sur un fichier du répertoire qui contient des pilotes (voir le tableau suivant pour plus d’informations). L’erreur se produit parce que Windows recherche le fichier spécifié dans un répertoire nommé « 12 », qui n’existe probablement pas sur l’ordinateur.

Le tableau suivant présente plusieurs dirids couramment utilisés et les répertoires qu’ils représentent. Les valeurs les plus couramment spécifiées par les fichiers INF d’appareils et les fichiers INF de pilotes sont répertoriées en haut du tableau.

Dans le cadre des exigences d'isolation de packages de pilotes, un pilote doit être exécuté à partir du magasin de pilotes et utiliser DIRID 13 pour spécifier l’emplacement des fichiers de package de pilotes lors de l’installation. À compter de Windows 11, version 24H2, certains des dirids couramment utilisés ont été déconseillés lors de l’envoi de votre INF pour une signature WHQL. Pour plus d'informations, voir InfVerif /h.

Les valeurs Dirid comprises entre 16384 et 32767 sont réservées aux dossiers d’interpréteurs de commandes spéciaux. Le tableau suivant présente les valeurs dirid pour ces dossiers.

Outre les valeurs de cette table définies dans Setupapi.h, vous pouvez utiliser l’une des valeurs CSIDL_Xxx définies dans Shlobj.h. Pour définir une valeur dirid pour un dossier non répertorié dans cette table, ajoutez 16384 (0x4000) à la valeur CSIDL_Xxx. Pour plus d'informations sur les valeurs CSIDL_Xxx, consultez la documentation SDK Windows.