通过

指定高级属性页的配置参数

  • 项目

注意

在 Windows 10 版本 1703 之前，驱动程序升级和 Windows 更新可能会导致驱动程序之前在“高级属性”页中定义的 INF 值发生更改。 从 Windows 10版本 1703 开始，驱动程序在其 INF 文件中指定的高级属性会通过这些更新一直保留。

安装 Net 组件 (适配器) 的 INF 文件可以指定要在组件的 “高级 属性”页中显示的适配器配置参数。 用户在 “高级 属性”页中指定的配置值将写入组件的根实例键。

请注意，如果适配器支持“高级属性”页，则适配器的“DDInstall”部分中的“特征”条目必须包含NCF_HAS_UI值。

网络 INF 文件通过组件的 DDInstall 节引用的 add-registry-section 指定要在“高级”页中显示的配置参数。 此类 add-registry-section 将一个或多个配置子项添加到 Ndi\params 项。 配置参数子项的格式为 Ndi\params\SubKeyName，其中 SubKeyName 是指定供应商特定参数名称的REG_SZ值。 例如，指定收发器类型的参数的键可以命名为 Ndi\params\收发器类型。

以下关键字是保留的，不能用作 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 值，如果参数为 numeric、Min、Max 和 Step 值。 下表描述了可添加到每个 Ndi\params 键的值。

名称 值 说明

ParamDesc

字符串

在 “高级 ”页上为参数显示的名称

类型

int、long、Word、dword、edit 或枚举

参数类型：int、long、Word 和 dword 指定数值参数;edit 和 enum 指定文本参数。

默认

默认值

参数的默认值：对于数值参数，必须是与指定参数类型匹配的 int、long、Word 或 dword) (数值;对于文本参数，必须是字符串。 必须为所需参数指定默认值。 还可以为可选参数指定默认值。 当用户选择为可选参数输入值的选项时，默认值（如果指定）将显示在该参数的编辑框中。

可选

0 或 1

需要 0 。 指定参数的值或使用默认值。 1 个可选。 可以在“高级”页上标记为“不存在”。

Min

数值

数值参数的最小值。

Max

数值

数值参数的最大值。

步骤

数值

步骤 (数值参数的有效值之间的间隔) 。 最小值是起始点。

枚举参数的值范围是使用以下格式的子项指定的：

Ndi\params\SubKeyName\enum

每个枚举值都必须有一个子项。 每个 枚举 子项指定一个数值 (从零开始的第一个枚举值) 以及该值的说明。

下面是添加名为 TransType 的配置参数的 add-registry-section 的示例。

[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)"