Указание параметров конфигурации для страницы "Дополнительные свойства"

Заметка

До Windows 10 версии 1703 обновления драйверов и Windows могли привести к изменению значений INF, которые драйвер ранее задавал на странице расширенных свойств . Начиная с Windows 10 версии 1703, расширенные свойства, указанные драйвером в INF-файле, сохраняются с помощью этих обновлений.

INF-файл, устанавливающий компонент Net (адаптер), может указывать параметры конфигурации адаптера для отображения на странице свойств Advanced для компонента. Значения конфигурации, указанные пользователем на странице свойств расширенных, записываются в качестве корневого ключа экземпляра компонента.

Обратите внимание, что если адаптер поддерживает страницу свойств Advanced, то запись характеристик в разделе DDInstall адаптера должна содержать значение NCF_HAS_UI.

Сетевой INF-файл указывает параметры конфигурации для отображения на странице "Дополнительно", используя раздел добавления в реестр, на который ссылается раздел DDInstall компонента. Такой раздел для добавления добавляет один или несколько подразделов конфигурации к ключу Ndi\params. Формат подраздела параметра конфигурации — Ndi\params\SubKeyName, где SubKeyName — это значение REG_SZ, указывающее имя параметра для конкретного поставщика. Например, ключ для параметра, указывающего тип транссивера, можно назвать Ndi\params\TransceiverType.

Следующие ключевые слова зарезервированы и не могут использоваться в качестве Ndi\params\SubKeyName: BundleId, BusType, Характеристики, ComponentId, Описание, DeviceInstanceId, DriverDate, DriverDesc, DriverVersion, InfPath, InfSection, InfSectionExt, IfType* InstallTimeStamp, Производитель, ТипМедиа, **NetCfgInstanceId, NetLuidIndex,ФизТипМедиа, **Поставщики **ИмяПоставщика.

Для каждого добавленного подраздела параметра в Ndi\params, раздел добавления в реестр должен добавить значения ParamDesc(описание параметра) и Тип. Раздел надстройки также может добавлять значения по умолчанию и необязательные для параметра, а если параметр числовой, значения Min, Maxи шага. В следующей таблице описаны значения, которые можно добавить к каждому ключу Ndi\params.

Имя	Ценность	Описание
ParamDesc	строка	Имя, отображаемое для параметра на странице расширенных
Тип	int, long, Word, dword, editили enum	Тип параметра: int, long, Wordи dword обозначают числовой параметр; edit и enum обозначают текстовый параметр.
По умолчанию	значение по умолчанию	Значение по умолчанию для параметра: для числового параметра должно быть числовым значением (int, длинные, Wordили dword), которое соответствует указанному типу параметра; для текстового параметра должен быть строкой. Значения по умолчанию должны быть указаны для обязательных параметров. Значения по умолчанию также можно указать для необязательных параметров. Когда пользователь выбирает опцию для ввода значения необязательного параметра, значение по умолчанию, если оно указано, отображается в окне ввода для этого параметра.
Необязательный	0 или 1	требуется 0. Укажите значение параметра или используйте значение по умолчанию. 1 необязательно. Можно пометить как Отсутствует на странице Расширенные.
Мин	числовое значение	Минимальное значение для числового параметра.
Макс	числовое значение	Максимальное значение для числового параметра.
Шаг	числовое значение	Шаг (интервал) между допустимыми значениями для числового параметра. Минимальное значение — начальная точка.

Диапазон значений для параметра перечисления задается с помощью вложенного ключа, имеющего следующий формат:

Ndi\params\SubKeyName\enum

Каждое перечисленное значение должно иметь вложенный ключ. Каждый подключ ключа перечисления задает числовое значение (начиная с нуля для первого перечисленного значения) и описание для этого значения.

Ниже приведен пример раздела добавления в реестр, который добавляет параметр конфигурации под названием TransType.

[a1.params.reg]
HKR, Ndi\params\TransType,      ParamDesc, 0, "Transceiver Type"
HKR, Ndi\params\TransType,      Type,      0, "enum"
HKR, Ndi\params\TransType,      Default,   0, "0"
HKR, Ndi\params\TransType,      Optional,  0, "0"
HKR, Ndi\params\TransType\enum, "0",       0, "Auto-Connector"
HKR, Ndi\params\TransType\enum, "1",       0, "Thick Net(AUI/DIX)"
HKR, Ndi\params\TransType\enum, "2",       0, "Thin Net (BNC/COAX)"
HKR, Ndi\params\TransType\enum, "3",       0, "Twisted-Pair (TPE)"