Параметры команды 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
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по