Указание параметров конфигурации для страницы "Дополнительные свойства"
Примечание
До Windows 10 версии 1703 обновления драйверов и Windows могли привести к изменению значений INF, определенных драйвером ранее на странице Дополнительные свойства. Начиная с Windows 10 версии 1703, дополнительные свойства, указанные драйвером в INF-файле, сохраняются в этих обновлениях.
INF-файл, устанавливающий сетевой компонент (адаптер), может указывать параметры конфигурации адаптера для отображения на странице Дополнительные свойства компонента. Значения конфигурации, указанные пользователем на странице Дополнительные свойства, записываются в корневой ключ экземпляра компонента.
Обратите внимание, что если адаптер поддерживает страницу расширенных свойств, запись Характеристики в разделе DDInstall для адаптера должна содержать значение NCF_HAS_UI.
Сетевой INF-файл задает параметры конфигурации для отображения на странице Дополнительно с помощью раздела add-registry-section , на который ссылается раздел DDInstall для компонента. Такой раздел add-registry-section добавляет один или несколько подразделов конфигурации в раздел Ndi\params . Формат подраздела параметра конфигурации — Ndi\params\SubKeyName, где SubKeyName — это значение REG_SZ, указывающее имя параметра конкретного поставщика. Например, ключ для параметра, указывающего тип приемопередатителя, может называться Ndi\params\TransceiverType.
Следующие ключевые слова зарезервированы и не могут использоваться в качестве Ndi\params\SubKeyName: BundleId, BusType, Characteristics, ComponentId, Description, DeviceInstanceId, DriverDate, DriverDesc, DriverVersion, InfPath, InfSection, InfSectionExt,** IfType* InstallTimeStamp, Manufacturer,** MediaType, **NetCfgInstanceId, NetLuidIndex,PhysicalMediaType, **Providerи **ProviderName.
Для каждого подраздела параметра, добавляемого в Ndi\params, раздел add-registry-section должен добавить значения ParamDesc(описание параметра) и Type . Раздел add-registry-section также может добавлять значения Default и Optional для параметра и, если параметр является числовым, значения Min, Max и Step . В следующей таблице описаны значения, которые можно добавить к каждому ключу Ndi\params .
| Имя | Значение | Описание |
|---|---|---|
ParamDesc |
String |
Имя, отображаемое для параметра на странице Дополнительно |
Тип |
int, long, Word, dword, edit или перечисление |
Тип параметра: int, long, Word и dword указывает числовой параметр; Edit и перечисление указывают текстовый параметр. |
По умолчанию |
значение по умолчанию |
Значение по умолчанию для параметра: для числового параметра должно быть числовым значением ( int, long, Word или dword), которое соответствует указанному типу параметра; для текстового параметра должно быть строкой. Для обязательных параметров необходимо указать значения по умолчанию. Значения по умолчанию также можно указать для необязательных параметров. Когда пользователь выбирает параметр для ввода значения для необязательного параметра, значение по умолчанию, если оно указано, отображается в поле редактирования для этого параметра. |
Необязательно |
0 или 1 |
Требуется 0 . Укажите значение параметра или используйте значение по умолчанию. 1 необязательный параметр. Можно пометить как не присутствует на странице Дополнительно . |
Min |
числовое значение |
Минимальное значение числового параметра. |
Max |
числовое значение |
Максимальное значение числового параметра. |
Шаг |
числовое значение |
Шаг (интервал) между допустимыми значениями для числового параметра. Минимальное значение является отправной точкой. |
Диапазон значений для параметра перечисления указывается с помощью подраздела, который имеет следующий формат:
Ndi\params\SubKeyName\enum
Каждое перечисленное значение должно иметь подраздел . Каждый подраздел перечисления задает числовое значение (начиная с нуля для первого перечисленного значения) и описание этого значения.
Ниже приведен пример раздела add-registry-section , который добавляет параметр конфигурации с именем 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)"