Usar Dirids

Muitos dos diretórios que aparecem em arquivos INF podem ser expressos usando identificadores de diretório (dirids), que são números que identificam diretórios específicos. Os aplicativos podem usar, mas não reatribuir, os diretórios definidos pelo sistema associados a dirids cujos valores são de -1 a 32.767.

Para criar dirids com valores definidos pelo usuário entre 32.768 e 65.534 ou de 65.536 em diante, use a função função SetupSetDirectoryId (descrita na documentação do SDK do Microsoft Windows).

Um dirid com um valor de 65.535 é considerado sinônimo de um dirid com um valor de -1, embora o último (dirid -1) seja preferido.

Se você pretende usar dirids no arquivo INF, considere as duas diretrizes a seguir:

1. Quando a sintaxe de uma entrada de arquivo INF especifica explicitamente um valor dirid (a seção INF DestinationDirs, por exemplo), expresse o valor em questão como número.

   O exemplo a seguir demonstra essa sintaxe.

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

2. Quando a sintaxe de uma entrada de arquivo INF especifica um caminho de arquivo, você pode usar uma substituição de cadeia de caracteres fornecida pelo sistema para representar parte do caminho ou o caminho na íntegra. Essa substituição tem a seguinte forma:

   %dirid%

   O formulário consiste em um caractere de porcentagem (%), seguido pelo dirid do diretório que você deseja especificar, seguido por outro caractere de porcentagem (%). Um caractere de barra invertida () final separa a expressão de um nome de arquivo seguinte ou de diretórios adicionais no caminho.

   O exemplo a seguir demonstra essa sintaxe.

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

   Quando totalmente expandido, o caminho mostrado no exemplo anterior passa a ser c:\windows\system32\drivers\aic78xx.sys (supondo que o Windows tenha instalado no diretório c:\windows). Lembre-se de que a substituição de cadeia de caracteres, ou formulário %dirid%, can pode ser usada em qualquer lugar em que uma cadeia de caracteres seja esperada, com exceção da seção de cadeias de caracteres INF do arquivo INF.

   Os dois exemplos a seguir mostram como a substituição de cadeia de caracteres não deve ser usada.

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

   No primeiro exemplo, a sintaxe da entrada DefaultDestDir requer que o valor seja um número. No entanto, a expressão %11% se expande para uma cadeia de caracteres. No segundo exemplo, o gravador INF aparentemente pretendia definir o valor da entrada ServiceBinary para um arquivo no diretório que contém drivers (veja a tabela a seguir para obter mais informações). O erro ocorre porque o Windows procura o arquivo especificado em um diretório chamado "12", que provavelmente não existe no computador.

A tabela a seguir mostra vários dirids comumente usados, bem como os diretórios que eles representam. Os valores mais especificados por arquivos INF de dispositivo e arquivos INF de driver são listados na parte superior da tabela.

Como parte dos requisitos de isolamento do pacote de drivers, um driver deve ser executado a partir da loja de drivers e usar o DIRID 13 para especificar o local dos arquivos do pacote de driver na instalação. Do Windows 11, versão 24H2, em diante, alguns dos dirids mais usados foram preteridos ao enviar seu INF para uma assinatura WHQL. Para obter informações, consulte InfVerif /h.

Os valores Dirid de 16384 a 32767 são reservados para pastas especiais do shell. A tabela a seguir mostra valores dirid para essas pastas.

Além dos valores na tabela definidos em Setupapi.h, você pode usar qualquer um dos valores CSIDL_Xxx definidos em Shlobj.h. Para definir um valor dirid para uma pasta não listada nesta tabela, adicione 16384 (0x4000) ao valor CSIDL_Xxx. Para obter mais informações sobre os valores CSIDL_Xxx, consulte a documentação do SDK do Windows.