Использование Dirids

Многие каталоги, отображаемые в INF-файлах, могут быть выражены с помощью идентификаторов каталогов (диридов), которые являются числами, определяющими определенные каталоги. Приложения могут использовать, но не могут переназначить системные каталоги, связанные с диридами , значения которых — от -1 до 32767.

Чтобы создать дириды с пользовательскими значениями от 32768 до 65534 или 65536 и выше, используйте функцию SetupSetDirectoryId (описанную в документации по пакету SDK Для Microsoft Windows).

Помните, что дирид со значением 65535 считается синонимом дирида со значением -1, хотя последний (dirid -1) предпочтителен.

Если вы планируете использовать дириды в INF-файле, рассмотрите следующие два правила:

1. Если синтаксис для записи INF-файла четко указывает значение dirid (например, в разделе INF DestinationDirs), выразите это значение в виде числа.

   В следующем примере показан этот синтаксис:

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

2. Если синтаксис для записи INF-файла указывает путь к файлу, можно использовать подстановку строки, предоставленной системой, для представления части или всего этого пути. Эта подстановка имеет следующую форму:

   % dirid%

   Эта форма состоит из символа процента (%), за которым следует идентификатор каталога, который вы хотите указать, а затем следует еще один символ процента (%). Завершающий символ обратной косой черты () отделяет это выражение от следующего имени файла или дополнительных каталогов в пути.

   В следующем примере показан этот синтаксис:

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

   При полном развертывании путь, показанный в предыдущем примере, становится c:\windows\system32\drivers\aic78xx.sys (если Windows установлен в каталоге c:\windows). Помните, что подстановку строки в виде %dirid% можно использовать в любом месте, где ожидается строка, за исключением раздела INF Strings инфо-файла.

   В двух следующих примерах показано, как не следует использовать подстановку строк.

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

   В первом примере синтаксис записи DefaultDestDir требует, чтобы его значение было числом. Однако выражение %11% расширяется в строку. Во втором примере средство записи INF, по-видимому, предназначено для задания значения для записи ServiceBinary в файле в каталоге, который содержит драйверы (дополнительные сведения см. в следующей таблице). Ошибка возникает из-за того, что Windows ищет указанный файл в каталоге с именем "12", который, вероятно, не существует на компьютере.

В следующей таблице показаны несколько часто используемых диридов и каталогов, которые они представляют. Значения, наиболее часто указанные в INF-файлах устройства и INF-файлах драйвера, перечислены в верхней части таблицы.

В рамках требований к изоляции пакетов драйверов драйвер должен запускаться из хранилища драйверов и использовать DIRID 13 для указания расположения файлов пакетов драйверов при установке. Начиная с Windows 11, версии 24H2, некоторые часто используемые dirids устарели при подаче вашего INF для получения подписи WHQL. Дополнительные сведения см. в разделе InfVerif /h.

Значения dirid от 16384 до 32767 зарезервированы для специальных папок оболочки. В следующей таблице показаны значения dirid для этих папок.

Помимо значений в этой таблице, определенных в Setupapi.h, можно использовать любое из значений CSIDL_Xxx, определенных в Shlobj.h. Чтобы задать значение dirid для папки, не перечисленной в этой таблице, добавьте 16384 (0x4000) к значению CSIDL_Xxx. Дополнительные сведения о значениях CSIDL_Xxx см. в документации по пакету SDK для Windows.