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


Параметры команды 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.

-d [ дата | \]
Указывает дату, записанную в директиве INF DriverVer. Формат даты : месяц,дата/год
(например, -d 20.10.2011).

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

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

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

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

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

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

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

-ccatalogfile
Указывает значение, записанное в директиве CatalogFile в разделе Версия INF. По умолчанию директива 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, от которую зависит этот драйвер. Используется для настройки имени совместного установщика 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.

-ipath
Указывает расположение файла 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 Для этого используйте свойства конфигурации-Inf2Cat-General-Use>>> Local Time. Теперь и Stampinf, и Inf2Cat используют местное время.

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

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

set PRIVATE_DRIVER_PACKAGE=1