Stampinf コマンドのオプション
Stampinf は、一般的な INF ファイル ディレクティブを更新するコマンド ライン ツールです。
Stampinf -f filename
[-s section]
[-d [date | *]]
[-a [architecture]]
[-c catalogfile]
[-v [time | *]]
[-k version]
[-u version]
[-i path]
[-n]
パラメーター
-f filename
処理する INF または INX ファイルを指定します。
-s section
INF DriverVer ディレクティブを追加する INF セクションを指定します。 このディレクティブの既定の場所は、INF Version セクションです。
-d [ date | \]
INF DriverVer ディレクティブに書き込まれる日付を指定します。 日付の書式は年 / 月 / 日です (たとえば、-d 2011 年 10 月 20 日)。
現在の日付を使うには、このパラメーターと共にアスタリスク (*) を指定します。
-d パラメーターが指定されていない場合、またはオプションなしで指定されている場合、Stampinf は次のいずれかの日付値を使用します。
STAMPINF_DATE 環境変数が設定されている場合、Stampinf はこの環境変数で指定された日付値を使用します。
STAMPINF_DATE 環境変数が指定されていない場合、Stampinf は現在の日付を使用します。
-a [ architecture ]
INX ファイルで使用される $ARCH$ 変数を置き換えるアーキテクチャ文字列を指定します。 $ARCH$ 変数は、INF Manufacturerセクション のTargetOSVersion装飾と、それぞれのセクション名を特定のプラットフォームにカスタマイズするために使用されます。 INX ファイルの詳細については、「INX ファイルを使用した INF ファイルの作成」を参照してください。
アーキテクチャ文字列の値は、x86、64(Itanium ベースのプラットフォームの場合)、x64 (amd64プラットフォームの場合) です。
-a パラメーターが指定されていない場合、またはオプションなしで指定されている場合、Stampinf は、ビルド環境ウィンドウで設定されている Platform 環境変数で指定された値を使用します。
-c catalogfile
INF Version セクションの 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 が2つのキーワードに (それぞれ) 使用されます。
-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 path
Ntverp.h ファイルの場所を指定します。 このパスは、Ntverp.h が含まれるディレクトリの完全修飾された場所を表します。
Comments
Stampinf が INF DriverVer ディレクティブに入力する日付値は、グリニッジ標準時とも呼ばれる協定世界時 (UTC) に基づいていません。 ただし、Inf2Cat は、この INF ディレクティブの日付値を UTC 値として解釈します。 これにより、Stampinf で使用されるローカルの日付値が、Inf2Cat によって明日の日付の UTC 値として解釈される場合、エラーが発生する可能性があります。 この問題を回避するには、次のいずれかの操作を行います。
- 環境変数 STAMPINF_DATE を適切な UTC 日付値に設定します。 ここで、-d パラメーターを指定せずに Stampinf を実行します。 これにより、STAMPINF_DATE 環境変数で指定された日付値を使用するように Stampinf に指示します。 これで、Stampinf と Inf2Cat の両方で UTC が使用されます。
- Inf2Cat が を設定するには、ドライバー パッケージのプロジェクト設定を変更します
/uselocaltime
。 このためには、[構成プロパティ] -> [Inf2Cat] -> [全般] -> [Use Local Time]\(現地時刻の使用\) を使用します。 これで、Stampinf と Inf2Cat の両方で現地時刻が使用されます。
ドライバーを開発するときに、環境変数PRIVATE_DRIVER_PACKAGE を設定できます。 この変数を設定すると、コマンド ラインの設定に関係なく、Stampinf は INF DriverVer ディレクティブに使用される日付とバージョンを現在の日付と時刻に設定します。 さらに、Stampinf は CatalogFile ディレクティブを設定します。 -c コマンド オプションでカタログが既に指定されていない限り、Stampinf は INF バージョン セクションに CatalogFile=delta.catを書き込みます。
[ビルド] ウィンドウに次のコマンドを入力して、この開発モードを有効にします。
set PRIVATE_DRIVER_PACKAGE=1