Secção da versão INF

Por convenção, a secção Versão aparece primeiro nos ficheiros INF. Cada ficheiro INF deve ter esta secção.

[Version]
 
Signature="signature-name"
[Class=class-name]
[ClassGuid={nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn}]
[Provider=%INF-creator%]
[ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}]
[LayoutFile=filename.inf [,filename.inf]... ]  (Windows 2000 and Windows XP)
[CatalogFile=filename.cat]
[CatalogFile.nt=unique-filename.cat]
[CatalogFile.ntx86=unique-filename.cat]
[CatalogFile.ntia64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntamd64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntarm=unique-filename.cat]  (Windows 8 and later versions of Windows)
[CatalogFile.ntarm64=unique-filename.cat]  (Windows 10 version 1709 and later versions of Windows)

DriverVer=mm/dd/yyyy,w.x.y.z
[PnpLockDown=0|1] (Windows Vista and later versions of Windows)
[DriverPackageDisplayName=%driver-package-description%]
[DriverPackageType=PackageType]

Entradas

Assinatura="nome-assinatura"
Deve ser $Windows NT$ ou $Chicago$. Isto indica os sistemas operativos para os quais este INF é válido. Estes valores de assinatura têm os seguintes significados.

Valor de assinatura	Meaning
$Windows NT$	Todos os sistemas operativos Windows
$Chicago$	Todos os sistemas operativos Windows

Os caracteres do cifrão anexo ($) são obrigatórios, mas estas cadeias não distinguem maiúsculas e maiúsculas. Se o nome da assinatura não for nenhum destes valores de cadeia, o ficheiro não é aceite como um INF válido.

Geralmente, o Windows não diferencia entre estes valores de assinatura. Um deles tem de ser especificado, mas não importa qual. Deve especificar o valor apropriado para que alguém que leia um ficheiro INF possa determinar os sistemas operativos para os quais se destina.

Alguns instaladores de classe impõem requisitos adicionais sobre como o valor da assinatura deve ser especificado. Tais requisitos, se existirem, são discutidos em secções específicas por tipo de dispositivo deste Windows Driver Kit (WDK).

Um INF deve fornecer informação de instalação específica do sistema operativo adicionando extensões definidas pelo sistema às suas secções DDInstall, quer o nome de assinatura seja $Windows NT$ ou $Chicago$. (Ver Criação de Ficheiros INF para Múltiplas Plataformas e Sistemas Operativos para uma discussão sobre estas extensões.)

Classe=nome da classe
Para qualquer tipo padrão de dispositivo, isto especifica o nome da classe de configuração do dispositivo para o tipo de dispositivo instalado usando este ficheiro INF. Este nome é geralmente um dos nomes de classe definidos pelo sistema, como Net ou Display, que estão listados no Devguid.h. Para mais informações, consulte System-Supplied Classes de Configuração de Dispositivos.

Se um INF especificar uma Classe, deve também especificar o valor GUID definido pelo sistema correspondente para a sua entrada no ClassGUID . Especificar o valor GUID correspondente para um dispositivo de qualquer classe de configuração de dispositivo pré-definida pode instalar o dispositivo e os seus drivers mais rapidamente, pois isto ajuda o código de configuração do sistema a otimizar a sua pesquisa INF.

Se um INF adicionar uma nova classe de configuração de dispositivos ao sistema, deverá fornecer um valor único de nome de classe insensível a maiúsculas minúsculas, que difere de qualquer uma das classes fornecidas pelo sistema no Devguid.h. O comprimento da cadeia do nome da classe deve ser de 32 caracteres ou menos. O INF deve especificar um valor GUID recentemente gerado para a entrada do ClassGUID . Veja também a Secção INF ClassInstall32.

Esta entrada é irrelevante para um INF que não instala nem um novo driver de dispositivo sob uma classe de configuração de dispositivo predefinida nem uma nova classe de configuração de dispositivo.

Note

Esta entrada é obrigatória para controladores de dispositivos instalados através do gestor Plug and Play (PnP).

ClassGuid={nnnnn-nnnn-nn-nnnn-nn}
Especifica a classe de configuração de dispositivo GUID. O valor GUID é formatado como mostrado aqui, onde cada n é um dígito hexadecimal.

Este valor GUID especifica a classe de configuração do dispositivo a atribuir aos dispositivos instalados a partir deste ficheiro INF. Este valor GUID específico da classe também identifica o instalador da classe do dispositivo para o tipo de dispositivo e fornecedor de página de propriedades específica da classe, se existirem.

Para uma nova classe de configuração de dispositivo, o INF deve especificar um valor ClassGUID recentemente gerado. Para mais informações sobre como criar GUIDs, consulte Utilização de GUIDs em Drivers. Veja também Classes de Configuração de Dispositivos.

Note

Esta entrada é obrigatória para drivers de dispositivos instalados através do gestor PnP.

ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx-xxxxxxxxxxxx}
Especifica o ID de extensão GUID ao criar um IF de extensão. O valor GUID é formatado como mostrado aqui, onde cada x é um dígito hexadecimal.

Ao criar a versão inicial de uma extensão INF, o INF deve especificar um valor de ExtensionId recentemente gerado. No entanto, ao atualizar um INF de extensão existente, o ExtensionId deve permanecer o mesmo para que múltiplas versões relacionadas do INF de extensão sejam versionadas umas contra as outras, em vez de serem tratadas como INF de extensão independentes que podem ser instaladas simultaneamente na mesma instância do dispositivo. Para mais informações sobre como criar INFs de extensão, consulte Utilização de um Ficheiro INF de Extensão.

Note

Esta entrada só é necessária ao criar uma extensão INF, conforme identificado ao especificar Class = Extension e ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}.

ClassVer=major.Minor
Reservado para uso no sistema, a menos que seja explicitamente exigido por uma classe de dispositivo como Impressora. Por exemplo, veja V4 Driver INF.

Provider=%criador de INF%
Identifica o fornecedor do ficheiro INF. Normalmente, isto é especificado como um % token OrganizationName% que é expandido mais tarde na secção Strings do ficheiro INF. O comprimento máximo, em caracteres, de um nome de fornecedor é LINE_LEN.

Por exemplo, ficheiros INF fornecidos com o sistema normalmente especificam o criador INF como %Msft% e definem %Msft% = "Microsoft" nas suas secções de Strings.

Note

Esta entrada é obrigatória para drivers de dispositivos instalados através do gestor PnP.

CatalogFile=filename.cat
Especifica que um ficheiro catálogo (. cat) deve ser incluído no meio de distribuição de um pacote de drivers.

Quando um pacote de drivers é submetido à Microsoft para assinatura digital, o WHQL fornece um ficheiro de catálogo para o pacote de drivers depois de o WHQL ter testado e atribuído assinaturas digitais ao pacote. Para mais informações sobre os testes e assinatura de pacotes de drivers IHV ou OEM, consulte WHQL Release Signature. Os ficheiros de catálogo não estão listados na secção SourceDisksFiles nem na diretiva CopyFiles do INF. O Windows assume que o ficheiro de catálogo está na mesma localização do ficheiro INF.

Os ficheiros INF fornecidos pelo sistema nunca têm entradas CatalogFile= porque o sistema operativo valida a assinatura de tal INF contra todos os ficheiros de xxx.cat fornecidos pelo sistema.

CatalogFile.nt=unique-filename.cat |
CatalogFile.ntx86=unique-filename.cat |
CatalogFile.ntia64=unique-filename.cat |
CatalogFile.ntamd64=unique-filename.cat
CatalogFile.ntarm=unique-filename.cat
CatalogFile.ntarm64=unique-filename.cat

Especifica outro nome de ficheiro único, determinado pelo autor INF, com a extensão . cat , de um ficheiro de catálogo. Se estas entradas opcionais forem omitidas, um dado CatalogFile=filename.cat é usado para validar as instalações de dispositivos/drivers WDM.

Se existir algum CatalogFile. decorado. xxx= entrada na secção Versão de um INF juntamente com uma entrada CatalogFile= sem decoração, assume-se que a entrada não decorada identifica um filename.cat para validar instalações de dispositivos, instalações de drivers, ou ambas nas plataformas para as quais uma entrada decorada não está especificada.

Qualquer ficheiro INF de driver de dispositivo multiplataforma que tenha CatalogFile= e CatalogFile.xxx= entradas devem fornecer um nome único determinado por IHV/OEM para cada ficheiro .cat.

Para mais informações sobre como utilizar as extensões .nt, .ntx86, .ntia64, .ntamd64, .ntarm e .ntarm64 , definidas pelo sistema, consulte Criação de Ficheiros INF para Múltiplas Plataformas e Sistemas Operativos.

Note

Como o mesmo ficheiro .cat pode ser usado em todas as plataformas suportadas, o uso desta entrada não é obrigatório nem recomendado. No entanto, deve usar esta entrada se quiser criar ficheiros .cat específicos de cada plataforma para o seu pacote de drivers.

DriverVer=mm/dd/yyyy,w.x.y.z
Esta entrada especifica a informação da versão dos drivers instalados por este ficheiro INF. A partir do Windows 2000, esta entrada é obrigatória.

Para informações sobre como especificar esta entrada, consulte a Diretiva INF DriverVer.

PnpLockDown=0|1
Especifica se o Plug and Play (PnP) impede que as aplicações modifiquem diretamente os ficheiros especificados pelo ficheiro INF de um pacote de drivers. Se a diretiva PnpLockDown estiver definida como 1, o PnP impede que as aplicações modifiquem diretamente os ficheiros copiados pelas diretivas INF CopyFiles . Caso contrário, se a diretiva não estiver incluída num ficheiro INF ou se o valor da diretiva for definido a zero, uma aplicação com privilégios de administrador pode modificar diretamente esses ficheiros. Ficheiros de drivers protegidos desta forma são designados como ficheiros de driver protegidos por terceiros.

Para garantir a integridade de uma instalação de driver PnP, as aplicações não devem modificar diretamente os ficheiros de driver que são copiados pelo ficheiro INF do pacote de drivers. As aplicações devem usar apenas os mecanismos de instalação de dispositivos fornecidos pelo Windows para atualizar os drivers PnP.

A partir do Windows Vista, um pacote de drivers deve definir o PnpLockDown para 1 para impedir que uma aplicação modifique diretamente os ficheiros dos drivers. No entanto, algumas aplicações existentes que desinstalam pacotes de drivers apagam diretamente os ficheiros dos drivers. Para manter a compatibilidade com estas aplicações, a diretiva PnpLockDown para este pacote de drivers deve ser definida como zero.

Note

Embora o PnP no Windows Vista e versões posteriores do Windows não exija que um ficheiro INF inclua uma diretiva PnpLockDown para instalar um driver, o PnP numa versão futura do Windows poderá exigir que os ficheiros INF para pacotes de drivers PnP incluam a diretiva PnpLockDown.

DriverPackageDisplayName=%driver-package-description%
Deprecated. Foi anteriormente utilizado pelos Drivers Install Frameworks (DIFx). Para informações sobre a desvalorização do DIFx, consulte as Diretrizes do DIFx.

DriverPackageType=PackageType
Deprecated. Foi anteriormente utilizado pelos Drivers Install Frameworks (DIFx). Para informações sobre a desvalorização do DIFx, consulte as Diretrizes do DIFx.

Remarks

Quando um pacote de drivers passa Microsoft Windows testes do Hardware Quality Lab (WHQL), o WHQL devolve ficheiros de catálogo .cat ao IHV ou OEM. Cada ficheiro .cat contém uma assinatura digitalmente encriptada para o pacote do driver. O IHV ou OEM deve listar estes ficheiros .cat na secção de Versão INF e deve fornecer os ficheiros no meio de distribuição, na mesma localização do ficheiro INF. Os ficheiros .cat têm de ser não comprimidos.

Note

Se uma secção de Versão INF não incluir pelo menos uma entradaxxx do CatalogFile ou do CatalogFile.nt, o driver é tratado como não assinado, e as datas indicadas na diretiva DriverVer não são apresentadas pelo Windows.

Para mais informações, consulte Assinaturas de Condutores.

Examples

O exemplo seguinte mostra uma secção de Versão típica de um simples pacote de drivers INF, seguida das secções obrigatórias de SourceDisksNames e SourceDisksFiles implícitas pelas entradas especificadas nesta secção de Versão de exemplo:

[Version]
Signature="$Windows NT$"
Class=SCSIAdapter
ClassGUID={4D36E97B-E325-11CE-BFC1-08002BE10318}
Provider=%INF_Provider%
CatalogFile=example.cat
DriverVer=01/29/2010,1.2.3.4
PnpLockdown=1

[SourceDisksNames]
;
; diskid = description[, [tagfile] [, <unused>, subdir]]
;
1 = %Disk_Description%,,,\WinNT

[SourceDisksFiles.x86]
;
; filename_on_source = diskID[, [subdir][, size]]
;
exampleDriver.sys = 1,\x86

; ...

[Strings]
INF_Provider="Contoso"
Disk_Description = "Contoso Drivers Disk"
; ...

Ver também

DDInstall

FonteDiscosNomes

FicheirosDeFonteDiscos

Cordas