Seção SourceDisksNames do INF
Uma seção SourceDisksNames identifica os discos de distribuição ou discos CD-ROM que contêm os arquivos de origem a serem transferidos para o computador de destino durante a instalação.
[SourceDisksNames] |
[SourceDisksNames.x86] |
[SourceDisksNames.ia64] | (Windows XP and later versions of Windows)
[SourceDisksNames.amd64] | (Windows XP and later versions of Windows)
[SourceDisksNames.arm] | (Windows 8 and later versions of Windows)
[SourceDisksNames.arm64] (Windows 10 version 1709 and later versions of Windows)
diskid = disk-description[,tag-or-cab-file] |
diskid = disk-description[,[tag-or-cab-file][,[unused][,path]]] |
diskid = disk-description[,[tag-or-cab-file],[unused],[path][,flags]] |
diskid = disk-description[,[tag-or-cab-file],[unused],[path],[flags][,tag-file]] (Windows XP and later versions of Windows)
...
Entradas
diskid
Especifica um inteiro nãonegativo, em formato decimal, que identifica um disco de origem. Esse valor não pode exigir mais de 4 bytes de armazenamento. Se houver mais de um disco de origem para a distribuição, cada entrada diskid nesta seção deverá ter um valor exclusivo, como 1, 2, 3 e assim por diante.
descrição do disco
Especifica um token %strkey% ou uma "cadeia de caracteres entre aspas" que descreve o conteúdo e/ou a finalidade do disco identificado por diskid. O instalador pode exibir o valor dessa cadeia de caracteres para o usuário final durante a instalação, por exemplo, para identificar um disco de origem a ser inserido em uma unidade em um estágio específico do processo de instalação.
Cada especificação %strkey% nesta seção deve ser definida na seção Cadeias de Caracteres do INF. Qualquer descrição de disco que não seja um token %strkey% é uma cadeia de caracteres visível pelo usuário que deve ser delimitada por caracteres de aspas duplas (") se tiver espaços à esquerda ou à direita.
tag-or-cab-file
Esse valor opcional especifica o nome de um arquivo de marca ou arquivo de marca (.cab) fornecido no disco de distribuição, na raiz de instalação ou no subdiretório especificado por caminho, se houver. O valor deve especificar apenas o nome do arquivo e a extensão, não qualquer diretório ou subdiretório.
O Windows usa um arquivo de marca para verificar se o usuário inseriu o disco de instalação correto. Os arquivos de marca são necessários para mídia removível e são opcionais para mídia fixa.
Se o Windows não encontrar arquivos de instalação por nome no meio de instalação e se tag-or-cab-file tiver a extensão .cab, o Windows o usa como o nome de um arquivo de gabinete que contém os arquivos de instalação.
Se um . A extensão cab é especificada, o Windows trata o arquivo como um arquivo de marca e um arquivo de gabinete, conforme explicado na seção Comentários a seguir.
Para o Windows XP e versões posteriores do Windows, consulte também os sinalizadores e os valores de entrada de arquivo de marca .
unused
Essa entrada não tem mais suporte para o Windows 2000 e versões posteriores do Windows.
path
Esse valor opcional especifica o caminho do diretório no disco de distribuição que contém arquivos de origem. O caminho é relativo à raiz de instalação e é expresso como \dirname1\dirname2..., e assim por diante. Se esse valor for omitido de uma entrada, os arquivos serão considerados na raiz de instalação do disco de distribuição.
Você pode usar uma seção SourceDisksFiles do INF para especificar subdiretórios, relativos a um determinado diretório de caminho, que contêm arquivos de origem. No entanto, os arquivos de marca e o arquivo de gabinete devem residir no diretório de caminho fornecido ou na raiz de instalação.
sinalizadores
Começando com o Windows XP, definir isso como 0x10 força o Windows a usar tag-or-cab-file como um nome de arquivo de gabinete e a usar o arquivo de marca como um nome de arquivo de marca. Caso contrário, os sinalizadores serão somente para uso interno.
tag-file
A partir do Windows XP, se os sinalizadores estiverem definidos como 0x10, esse valor opcional especificará o nome de um arquivo de marca fornecido no meio de distribuição, seja na raiz de instalação ou no subdiretório especificado pelo caminho. O valor deve especificar o nome do arquivo e a extensão sem informações de caminho. Para obter mais informações, consulte a seção Comentários.
Comentários
Uma seção SourceDisksNames pode ter qualquer número de entradas, uma para cada disco de distribuição. Qualquer INF com uma seção SourceDisksNames também deve ter uma seção SOURCEDisksFiles do INF. (Por convenção, as seções SourceDisksNames e SourceDisksFiles seguem a seção Versão do INF.)
Essas seções nunca aparecem em arquivos INF fornecidos pelo sistema. Em vez disso, os arquivos INF fornecidos pelo sistema especificam entradas LayoutFile em suas seções de Versão .
As entradas em uma seção SourceDisksNames podem ter um dos dois formatos, um dos quais tem suporte apenas no Windows XP e versões posteriores do Windows.
No primeiro formato, o parâmetro tag-or-cab-file pode especificar um arquivo de marca ou um arquivo de gabinete. Ao encontrar esse formato, o Windows usa o seguinte algoritmo:
Trate o valor tag-or-cab-file como um nome de arquivo de marca e procure o arquivo no meio de instalação. Se o meio for removível e o arquivo de marca não for encontrado, solicite ao usuário o meio correto. Se o meio for corrigido e nem o arquivo de marca nem o primeiro arquivo a ser instalado puderem ser encontrados, solicite ao usuário o meio correto.
Tente copiar arquivos de instalação diretamente do meio.
Trate o valor tag-or-cab-file como um arquivo .cab e procure o arquivo.
Tente copiar arquivos de instalação do arquivo .cab .
Solicite que o usuário solicite arquivos não encontrados.
O segundo formato tem suporte no Windows XP e versões posteriores do Windows. Com esse formato, você pode usar as entradas tag-or-cab-file, flags e tag-file para especificar um arquivo .cab e um arquivo de marca. Quando ele encontra esse formato, o Windows usa o seguinte algoritmo:
Se o meio de instalação for removível, procure um arquivo de marca que corresponda ao nome do arquivo especificado pelo arquivo de marca. Se o arquivo não for encontrado, solicite ao usuário o meio correto. Se o meio for corrigido, procure o arquivo de marca ou o arquivo de gabinete. Se nenhum arquivo for encontrado, solicite ao usuário o meio correto.
Tente copiar arquivos de instalação do arquivo .cab especificado por tag-or-cab-file.
Solicite que o usuário solicite arquivos não encontrados.
Para qualquer um dos formatos, você deve fornecer um arquivo de marca diferente, com um nome de arquivo diferente, para cada versão dos arquivos de driver.
Para dar suporte à distribuição de arquivos de driver em várias arquiteturas do sistema, você pode especificar uma seção SourceDisksNames específica da arquitetura adicionando uma extensão .x86, .ia64, .amd64 ou outra extensão de arquitetura a SourceDisksNames.
Lembre-se de que, ao contrário de outras seções, como uma seção DDInstall , as extensões de plataforma para uma seção SourceDisksNames não são .ntx86, .ntia64, .ntamd64 etc. Por exemplo, para especificar uma seção de nomes de disco de origem para um sistema baseado em x86, use uma seção SourceDisksNames.x86 , não uma seção SourceDisksNames.ntx86 . Da mesma forma, use uma seção SourceDisksNames.ia64 para especificar um sistema baseado em Itanium e uma seção SourceDisksNames.amd64 para especificar um sistema baseado em x64.
Durante a instalação, as funções SetupAPI procuram seções SourceDisksNames específicas da arquitetura antes de usar a seção genérica. Por exemplo, se, durante a instalação em uma plataforma baseada em x86, um arquivo INF fizer referência ao disco "2", as funções de instalação do dispositivo procurarão uma entrada para o disco "2" em SourceDisksNames.x86 antes de procurar em SourceDisksNames.
As funções de instalação do dispositivo usam SourceDisksNames e SourceDisksNames.seções de arquitetura que estão no mesmo arquivo INF que a seção SourceDisksFiles relevante.
Exemplos
No exemplo a seguir, o arquivo write.exe é o mesmo para todas as plataformas Windows e está localizado no subdiretório \common , na raiz de instalação, em um disco de distribuição CD-ROM. O arquivocmd.exe é um arquivo específico da plataforma que só é usado em plataformas baseadas em x86.
[SourceDisksNames]
1 = "Windows NT CD-ROM",file.tag,,\common
[SourceDisksNames.x86]
2 = "Windows NT CD-ROM",file.tag,,\x86
[SourceDisksFiles]
write.exe = 1
cmd.exe = 2
O exemplo a seguir usa entradas que contêm especificações separadas para arquivos .tag e arquivos .cab .
[SourceDisksNames]
1 = "Dajava","Dajava.cab",,,0x10,"Dajava.tag"
2 = "Osc","Osc.cab",,,0x10,"OSC.tag"
3 = "Win","Win.cab",,,0x10,"Win.tag"
4 = "XMLDSO","XMLDSO.cab",,,0x10,"XMLDSO.tag"
[SourceDisksFiles]
ArrayBvr.class=1
BvrCallback.class=1
BvrsToRun.class=1
choice.osc=2
custom.osc=2
login.osc=2
mwcload.exe=3
mwcloadw.exe=3
mwclw32.dll=3
Atom.class=4
DTD.class=4
Entity.class=4
Entry.class=4
[DestinationDirs]
Test = 13
[DefaultInstall]
CopyFiles = Test
[Test]
ArrayBvr.class
mwcloadw.exe
Entity.class
custom.osc
BvrCallback.class
BvrsToRun.class
choice.osc
login.osc
mwcload.exe
mwclw32.dll
Atom.class
DTD.class
Entry.class
[Strings]
Msft = "Microsoft"