Opções de comando Stampinf

  • Artigo

Stampinf é uma ferramenta de linha de comando que atualiza diretivas de arquivo INF comuns.

Stampinf -f filename 
[-s section] 
[-d [date | *]] 
[-a [architecture]] 
[-c catalogfile]
[-v [time | *]]
[-k version] 
[-u version]
[-i path]
[-n]

Parâmetros

-f Filename
Especifica o arquivo INF ou INX a ser processado.

-s seção
Especifica a seção INF na qual colocar a diretiva INF DriverVer. O local padrão para essa diretiva é a seção Versão INF.

-d [ data\ | ]
Especifica a data gravada na diretiva INF DriverVer. O formato da data é mês/data/ano (por exemplo, -d 20/10/2011).

Para usar a data atual, especifique um asterisco (*) com esse parâmetro.

Se o parâmetro -d não for especificado ou for especificado sem nenhuma opção, o Stampinf usará um dos seguintes valores de data:

  • Se a variável de ambiente STAMPINF_DATE estiver definida, o Stampinf usará o valor de data especificado por essa variável de ambiente.

  • Se a variável de ambiente STAMPINF_DATE não for especificada, o Stampinf usará a data atual.

-a [ arquitetura ]
Especifica a cadeia de caracteres de arquitetura para substituir a variável $ARCH$ usada em arquivos INX. A variável $ARCH$ é usada para personalizar uma decoração TargetOSVersion em uma seção Fabricante INF e seu respectivo nome de seção, para uma plataforma específica. Para obter mais informações sobre a variável $ARCH$, consulte Usando arquivos INX para criar arquivos INF.

Os valores da cadeia de caracteres de arquitetura são x86, 64 (para plataformas baseadas em Itanium) e x64 (para plataformas amd64).

Se o parâmetro -a não for especificado ou for especificado sem nenhuma opção, o Stampinf usará o valor especificado pela variável de ambiente Platform, que é definida na janela do ambiente de compilação.

-c arquivo de catálogo
Especifica o valor gravado na diretiva CatalogFile na seção Versão INF. Por padrão, a diretiva CatalogFile não é gravada.

-v [ hora | *]
Especifica a hora gravada na diretiva INF DriverVer para o número de versão. O formato da hora é horas.minutos.segundos.milissegundos (por exemplo, 11.30.20.15). Essa opção é útil durante o desenvolvimento porque fornece uma maneira conveniente de aumentar o número da versão do driver.

Para usar a hora atual, especifique um asterisco (*) com esse parâmetro.

Se o parâmetro -v não for especificado ou for especificado sem nenhuma opção, o Stampinf usará um dos seguintes valores de número de versão:

  • Se a variável de ambiente STAMPINF_VERSION estiver definida, o Stampinf usará o valor do número de versão especificado por essa variável de ambiente.

  • Se a variável de ambiente STAMPINF_VERSION não for especificada, o Stampinf extrairá o número da versão do arquivo Ntverp.h.

-k Versão
Especifica a versão do KMDF da qual esse driver depende. Isso é usado para personalizar o nome do co-instalador KmdfLibraryVersion e KMDF no arquivo INF. Essa opção substitui as palavras-chave $KMDFVERSION$ e $KMDFCOINSTALLERVERSION$ no arquivo INF. A string tem o seguinte formato:

<major_version>.<minor_version>

Por exemplo, se você especificar 1.5 como a cadeia de caracteres de versão, os valores 1.5 e 01005 serão usados para as duas palavras-chave (respectivamente).

-u Versão
Especifica a versão do UMDF da qual esse driver depende. Essa opção é usada para especificar o nome do co-instalador UmdfLibraryVersion e UMDF no arquivo INF. A versão especificada substitui as palavras-chave $UMDFVERSION$ e $UMDFCOINSTALLERVERSION$ no arquivo INF. A string de versão tem o seguinte formato:

<major_version>.<minor_version>.<service_version>

(em que <> service_version é normalmente zero).

Por exemplo, se você especificar 1.5.0 como a cadeia de caracteres de versão, os valores 1.5.0 e 01005 serão usados para as palavras-chave principais e secundárias (respectivamente).

-n
Mostra a saída detalhada do Stampinf.

-i caminho
Especifica o local do arquivo Ntverp.h. O caminho representa um local totalmente qualificado do diretório que contém Ntverp.h

Comentários

O valor de data que o Stampinf coloca na diretiva INF DriverVer não se baseia no UTC (Tempo Universal Coordenado), que também é conhecido como Horário de Greenwich. No entanto, o Inf2Cat interpreta o valor de data dessa diretiva INF como um valor UTC. Isso pode levar a erros se o valor de data local usado pelo Stampinf for interpretado pelo Inf2Cat como um valor UTC para a data de amanhã. Para evitar esse problema, siga um destes procedimentos:

  • Defina a variável de ambiente STAMPINF_DATE para o valor de data UTC apropriado. Agora execute o Stampinf sem especificar o parâmetro -d . Isso instrui o Stampinf a usar o valor de data especificado pela variável de ambiente STAMPINF_DATE. Agora, tanto o Stampinf quanto o Inf2Cat usam UTC.
  • Altere as configurações do projeto do pacote de driver para que o Inf2Cat defina /uselocaltime. Para fazer isso, use Configuration Properties-Inf2Cat-General-Use>>> Local Time. Agora, tanto o Stampinf quanto o Inf2Cat usam o horário local.

Ao desenvolver seu driver, você pode definir a variável de ambiente PRIVATE_DRIVER_PACKAGE. Quando essa variável é definida, Stampinf define a data e a versão usadas para a diretiva INF DriverVer para a data e hora atuais, independentemente das configurações de linha de comando. Além disso, Stampinf define a diretiva CatalogFile . Stampinf grava CatalogFile=delta.cat na seção Versão INF, a menos que um catálogo já tenha sido especificado com a opção de comando -c.

Digite o seguinte comando em uma janela de compilação para habilitar esse modo de desenvolvimento:

set PRIVATE_DRIVER_PACKAGE=1