Поделиться через


Параметры команды 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, в котором необходимо поместить директиву INF DriverVer. Расположение по умолчанию для этой директивы — это раздел INF Version.

-d [ дата | \]
Указывает дату, написанную в директиве INF DriverVer. Формат даты — month/date/year
(например, -d 10/20/2011).

Чтобы использовать текущую дату, укажите звездочку (*) с этим параметром.

Если параметр -d не указан или не указан без каких-либо параметров, Stampinf использует одно из следующих значений даты:

  • Если задана переменная среды STAMPINF_DATE, Stampinf использует значение даты, указанное этой переменной среды.

  • Если переменная среды STAMPINF_DATE не указана, Stampinf использует текущую дату.

-a [ архитектура ]
Указывает строку архитектуры для замены переменной $ARCH$, используемой в файлах INX. Переменная $ARCH$ используется для настройки украшения TargetOSVersion в разделе INF Manufacturer и соответствующего имени раздела на определенную платформу. Дополнительные сведения о переменной $ARCH$ см. в разделе "Использование INX-файлов для создания INF-файлов".

Значения строки архитектуры : x86, 64 (для платформ на основе Itanium) и x64 (для платформ amd64).

Если параметр -a не указан или не указан без каких-либо параметров, Stampinf использует значение, указанное переменной среды Platform, которая устанавливается в окне среды сборки.

-c catalogfile
Указывает значение, записанное в директиве CatalogFile в разделе INF Version. По умолчанию директива CatalogFile не записывается.

-v [ время | *]
Указывает время записи в директиве INF DriverVer для номера версии. Формат времени — hours.minutes.seconds.milliseconds (например, 11.30.20.15). Этот параметр полезен во время разработки, так как он предоставляет удобный способ увеличить номер версии драйвера.

Чтобы использовать текущее время, укажите звездочку (*) с этим параметром.

Если параметр -v не указан или не указан без каких-либо параметров, Stampinf использует одно из следующих значений номера версии:

  • Если задана переменная среды STAMPINF_VERSION, Stampinf использует значение номера версии, указанное этой переменной среды.

  • Если переменная среды STAMPINF_VERSION не указана, Stampinf извлекает номер версии из файла Ntverp.h.

-k Версия
Указывает версию KMDF, от которой зависит этот драйвер. Это используется для настройки имени совместного установщика KmdfLibraryVersion и KMDF в INF-файле. Этот параметр заменяет ключевые слова $KMDFVERSION$ и $KMDFCOINSTALLERVERSION$ в INF-файле. Строка имеет следующий формат:

<>major_version.<minor_version>

Например, если в качестве строки версии указать 1.5, значения 1.5 и 01005 используются для двух ключевых слов (соответственно).

-u Версия
Указывает версию UMDF, от которой зависит этот драйвер. Этот параметр используется для указания имени совместного установщика UmdfLibraryVersion и UMDF в INF-файле. Указанная версия заменяет ключевые слова $UMDFVERSION$ и $UMDFCOINSTALLERVERSION$ в INF-файле. Строка версии имеет следующий формат:

<>major_version.<>minor_version.<service_version>

(где <> service_version обычно равно нулю.

Например, если в качестве строки версии указать 1.5.0, значения 1.5.0 и 01005 используются для основных и дополнительных ключевых слов (соответственно).

-n
Отображает подробные выходные данные Stampinf.

-i path
Указывает расположение файла Ntverp.h. Путь представляет полное расположение каталога, содержащего Ntverp.h

Комментарии

Значение даты, которое Stampinf помещает в директиву INF DriverVer, не основано на универсальном времени (UTC), который также известен как среднее время Greenwich. Однако Inf2Cat интерпретирует значение даты этой директивы INF как значение UTC. Это может привести к ошибкам, если локальное значение даты, используемое Stampinf, интерпретируется Inf2Cat как значение UTC для даты завтрашнего дня. Чтобы избежать этой проблемы, выполните одно из следующих действий.

  • Задайте для переменной среды STAMPINF_DATE соответствующее значение даты UTC. Теперь запустите Stampinf без указания параметра -d . Это указывает Stampinf использовать значение даты, указанное переменной среды STAMPINF_DATE. Теперь и Stampinf, и Inf2Cat используют UTC.
  • Измените параметры проекта пакета драйвера, чтобы установить /uselocaltimeInf2Cat. Для этого используйте свойства конфигурации-Inf2Cat-General-Use>>> Local Time. Теперь и Stampinf, и Inf2Cat используют локальное время.

При разработке драйвера можно задать переменную среды PRIVATE_DRIVER_PACKAGE. Если эта переменная задана, Stampinf задает дату и версию, которая используется для директивы INF DriverVer текущей датой и временем, независимо от параметров командной строки. Кроме того, Stampinf задает директиву CatalogFile . Stampinf записывает CatalogFile=delta.cat в разделе INF Version, если каталог не указан с параметром команды -c .

Введите следующую команду в окне сборки, чтобы включить этот режим разработки:

set PRIVATE_DRIVER_PACKAGE=1