Stampinf 命令選項
Stampinf 是一種命令行工具,可更新常見的 INF 檔案指示詞。
Stampinf -f filename
[-s section]
[-d [date | *]]
[-a [architecture]]
[-c catalogfile]
[-v [time | *]]
[-k version]
[-u version]
[-i path]
[-n]
參數
-f 檔名
指定要處理的 INF 或 INX 檔案。
-s 區段
指定要在其中放置 INF DriverVer 指示詞的 INF 區段。 這個指示詞的預設位置是 INF 版本區段。
-d [ date\ | ]
指定以 INF DriverVer 指示詞撰寫的日期。 日期的格式為 month/date/year (例如 -d 10/20/20/2011)。
若要使用目前的日期,請使用此參數指定星號 。
如果未指定 -d 參數,或未指定任何選項,Stampinf 會使用下列其中一個日期值:
如果已設定STAMPINF_DATE環境變數,Stampinf 會使用這個環境變數所指定的日期值。
如果未指定STAMPINF_DATE環境變數,Stampinf 會使用目前的日期。
-a [ architecture ]
指定 架構 字串,以取代 INX 檔案中使用的 $ARCH$ 變數。 $ARCH$ 變數可用來將 INF Manufacturer 區段中的 TargetOSVersion 裝飾,以及其各自的區段名稱自定義為特定平臺。 如需 $ARCH$ 變數的詳細資訊,請參閱 使用 INX 檔案建立 INF 檔案。
架構字串的值是 x86、64(適用於 Itanium 型平臺),以及 x64 (適用於 amd64 平臺)。
如果未指定 -a 參數,或未指定任何選項,Stampinf 會使用 Platform 環境變數所指定的值,而這個值是在建置環境視窗中設定。
-c catalogfile
指定 INF 版本區段中 CatalogFile 指示詞中寫入的值。 根據預設, 不會寫入 CatalogFile 指示詞。
-v [ time | *]
指定在版本號碼的 INF DriverVer 指示詞中寫入的時間。 時間的格式為 hours.minutes.seconds.milliseconds (例如 11.30.20.15)。 此選項在開發期間很有用,因為它提供增加驅動程式版本號碼的便利方式。
若要使用目前的時間,請使用此參數指定星號 。
如果未指定 -v 參數,或未指定任何選項,Stampinf 會使用下列其中一個版本號碼值:
如果已設定STAMPINF_VERSION環境變數,Stampinf 會使用這個環境變數所指定的版本號碼值。
如果未指定STAMPINF_VERSION環境變數,Stampinf 會從 Ntverp.h 檔案擷取版本號碼。
-k 版本
指定 此驅動程式相依的 KMDF 版本 。 這可用來自定義 INF 檔案中的 KmdfLibraryVersion 和 KMDF 共同安裝程式名稱。 此選項會取代 INF 檔案中的 $KMDFVERSION$ 和 $KMDFCOINSTALLERVERSION$ 關鍵詞。 字串的格式如下:
<>major_version。<minor_version>
例如,如果您將 1.5 指定為版本字串,則兩個關鍵詞會分別使用值 1.5 和 01005。
-u 版本
指定 此驅動程式相依的 UMDF 版本 。 此選項可用來在 INF 檔案中指定 UmdfLibraryVersion 和 UMDF 共同安裝程序名稱。 指定的 版本 會取代 INF 檔案中的 $UMDFVERSION$ 和 $UMDFCOINSTALLERVERSION$ 關鍵詞。 版本字串具有下列格式:
<major_version>。<>minor_version。<service_version>
(其中<>service_version通常是零)。
例如,如果您將 1.5.0 指定為版本字串,則主要和次要關鍵詞會分別使用 1.5.0 和 01005 值。
-n
顯示詳細資訊的 Stampinf 輸出。
-i 路徑
指定 Ntverp.h 檔案的位置。 路徑代表包含 Ntverp.h 之目錄的完整位置
註解
Stampinf 放入 INF DriverVer 指示詞中的日期值不是以國際標準時間(UTC)為基礎,也稱為格林威治平均時間。 不過, Inf2Cat 會將這個 INF 指示詞的日期值解譯為 UTC 值。 如果 Stampinf 所使用的本機日期值被 Inf2Cat 解譯為明天日期的 UTC 值,這可能會導致錯誤。 若要避免此問題,請執行 下列其中一項 :
- 將STAMPINF_DATE環境變數設定為適當的 UTC 日期值。 現在,執行 Stampinf 而不指定 -d 參數。 這會指示 Stampinf 使用STAMPINF_DATE環境變數所指定的日期值。 現在 Stampinf 和 Inf2Cat 都使用 UTC。
- 變更驅動程式套件項目設定,讓 Inf2Cat 設定
/uselocaltime
。 若要這樣做,請使用 Configuration Properties-Inf2Cat-General-Use>>> Local Time。 現在,Stampinf 和 Inf2Cat 都會使用當地時間。
當您開發驅動程式時,您可以設定環境變數PRIVATE_DRIVER_PACKAGE。 設定此變數時,Stampinf 會將 INF DriverVer 指示詞所使用的日期和時間,不論命令行設定為何。 此外,Stampinf 會設定 CatalogFile 指示詞。 Stampinf 會在 INF 版本區段中寫入 CatalogFile=delta.cat,除非已經使用 -c 命令選項指定目錄。
在建置視窗中輸入下列命令,以啟用此開發模式:
set PRIVATE_DRIVER_PACKAGE=1