Condividi tramite

Opzioni del comando Stampinf

  • Articolo

Stampinf è uno strumento da riga di comando che aggiorna le direttive comuni dei file INF.

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

Parametri

-f Filename
Specifica il file INF o INX da elaborare.

-s sezione
Specifica la sezione INF in cui inserire la direttiva INF DriverVer. Il percorso predefinito per questa direttiva è la sezione Versione INF.

-d [ date | \]
Specifica la data scritta nella direttiva INF DriverVer. Il formato per la data è mese/data/anno (ad esempio, -d 10/20/2011).

Per utilizzare la data corrente, specificare un asterisco (*) con questo parametro.

Se il parametro -d non viene specificato o viene specificato senza alcuna opzione, Il parametro Stampinf utilizza uno dei valori di data seguenti:

  • Se la variabile di ambiente STAMPINF_DATE è impostata, Stampinf usa il valore di data specificato da questa variabile di ambiente.

  • Se la variabile di ambiente STAMPINF_DATE non è specificata, Stampinf usa la data corrente.

-a [ architettura ]
Specifica la stringa di architettura per sostituire la variabile $ARCH$ utilizzata nei file INX. La variabile $ARCH$ viene usata per personalizzare una decorazione TargetOSVersion in una sezione INF Manufacturer e il relativo nome di sezione in una piattaforma specifica. Per altre informazioni sulla variabile $ARCH$, vedere Uso di file INX per la creazione di file INF.

I valori per la stringa di architettura sono x86, 64 (per le piattaforme basate su Itanium) e x64 (per le piattaforme amd64).

Se il parametro -a non viene specificato o viene specificato senza alcuna opzione, Stampinf usa il valore specificato dalla variabile di ambiente Platform, che viene impostata nella finestra dell'ambiente di compilazione.

-c catalogfile
Specifica il valore scritto nella direttiva CatalogFile nella sezione VERSIONE INF. Per impostazione predefinita, la direttiva CatalogFile non è scritta.

-v [ time | *]
Specifica l'ora scritta nella direttiva INF DriverVer per il numero di versione. Il formato per l'ora è hours.minutes.seconds.milliseconds (ad esempio, 11.30.20.15). Questa opzione è utile durante lo sviluppo perché offre un modo pratico per aumentare il numero di versione del driver.

Per usare l'ora corrente, specificare un asterisco (*) con questo parametro.

Se il parametro -v non viene specificato o viene specificato senza alcuna opzione, Stampinf utilizza uno dei valori di numero di versione seguenti:

  • Se la variabile di ambiente STAMPINF_VERSION è impostata, Stampinf usa il valore del numero di versione specificato da questa variabile di ambiente.

  • Se la variabile di ambiente STAMPINF_VERSION non è specificata, Stampinf estrae il numero di versione dal file Ntverp.h.

-Okay Versione
Specifica la versione di KMDF da cui dipende questo driver. Viene usato per personalizzare il nome del co-programma di installazione KmdfLibraryVersion e KMDF nel file INF. Questa opzione sostituisce le parole chiave $KMDFVERSION$ e $KMDFCOINSTALLERVERSION$ nel file INF. La stringa ha il formato seguente:

<>major_version.<minor_version>

Ad esempio, se si specifica 1.5 come stringa di versione, i valori 1.5 e 01005 vengono usati rispettivamente per le due parole chiave.

-u Versione
Specifica la versione di UMDF da cui dipende questo driver. Questa opzione viene usata per specificare il nome del co-programma di installazione UmdfLibraryVersion e UMDF nel file INF. La versione specificata sostituisce le parole chiave $UMDFVERSION$ e $UMDFCOINSTALLERVERSION$ nel file INF. La stringa di versione ha il formato seguente:

<>major_version.<>minor_version.<service_version>

(dove <> service_version è in genere zero).

Ad esempio, se si specifica 1.5.0 come stringa di versione, i valori 1.5.0 e 01005 vengono usati rispettivamente per le parole chiave principali e secondarie.

-n
Mostra l'output dettagliato di Stampinf.

-i path
Specifica il percorso del file Ntverp.h. Il percorso rappresenta una posizione completa della directory che contiene Ntverp.h

Commenti

Il valore della data che Stampanf inserisce nella direttiva INF DriverVer non è basato sull'ora UTC (Coordinated Universal Time ), noto anche come Ora di Greenwich. Tuttavia, Inf2Cat interpreta il valore di data di questa direttiva INF come valore UTC. Ciò potrebbe causare errori se il valore della data locale utilizzato da Stampinf viene interpretato da Inf2Cat come valore UTC per la data di domani. Per evitare questo problema, eseguire una delle operazioni seguenti:

  • Impostare la variabile di ambiente STAMPINF_DATE sul valore di data UTC appropriato. Eseguire ora Stampinf senza specificare il parametro -d . Ciò indica a Stampinf di usare il valore di data specificato dalla variabile di ambiente STAMPINF_DATE. Ora sia Stampinf che Inf2Cat usano l'ora UTC.
  • Modificare le impostazioni del progetto del pacchetto driver in modo che Inf2Cat imposti /uselocaltime. A tale scopo, usare proprietà di configurazione-Inf2Cat-General-Use>>> Local Time. Ora sia Stampinf che Inf2Cat usano l'ora locale.

Quando si sviluppa il driver, è possibile impostare la variabile di ambiente PRIVATE_DRIVER_PACKAGE. Quando questa variabile è impostata, Stampinf imposta la data e la versione usata per la direttiva INF DriverVer sulla data e l'ora correnti, indipendentemente dalle impostazioni della riga di comando. Inoltre, Stampinf imposta la direttiva CatalogFile . Stampinf scrive CatalogFile=delta.cat nella sezione VERSIONE INF, a meno che non sia già stato specificato un catalogo con l'opzione di comando -c.

Digitare il comando seguente in una finestra di compilazione per abilitare questa modalità di sviluppo:

set PRIVATE_DRIVER_PACKAGE=1