Especificar parámetros de configuración para la página Propiedades avanzadas

Nota

Antes de Windows 10, versión 1703, las actualizaciones de controladores y las actualizaciones de Windows podían dar lugar a cambios en los valores INF que el controlador había definido anteriormente en la página De propiedades avanzadas. A partir de Windows 10, versión 1703, las propiedades avanzadas que un controlador especifica en su archivo INF persisten a través de estas actualizaciones.

Un archivo INF que instala un componente net (adaptador) puede especificar parámetros de configuración del adaptador para mostrarlos en la página De propiedades avanzadas del componente. Los valores de configuración especificados por el usuario en la página Propiedades avanzadas se escriben en la clave de instancia raíz del componente.

Tenga en cuenta que si un adaptador admite una página de propiedades avanzadas , la entrada Características de la sección DDInstall del adaptador debe incluir el valor de NCF_HAS_UI.

Un archivo INF de red especifica los parámetros de configuración para su presentación en la página Avanzadas a través de una sección add-registry a la que hace referencia la sección DDInstall del componente. Esta sección add-registry-section agrega una o varias subclaves de configuración a la clave Ndi\params . El formato de una subclave de parámetro de configuración es Ndi\params\SubKeyName, donde SubKeyName es un valor de REG_SZ que especifica un nombre de parámetro específico del proveedor. Por ejemplo, la clave de un parámetro que especifica un tipo de transceptor podría denominarse Ndi\params\TransceiverType.

Las siguientes palabras clave están reservadas y no se pueden usar como Ndi\params\SubKeyName: BundleId, BusType, Characteristics, ComponentId, Description, DeviceInstanceId, DriverDate, DriverDesc, DriverVersion, InfPath, InfSection, InfSectionExt,** IfType* InstallTimeStamp, Manufacturer,** MediaType, **NetCfgInstanceId, NetLuidIndex,PhysicalMediaType, **Providery **ProviderName.

Para cada subclave de parámetro que se agrega a Ndi\params, la sección add-registry-section debe agregar los valores ParamDesc(parameter description) y Type . La sección add-registry-también puede agregar valores Predeterminado y Opcional para el parámetro y, si el parámetro es numérico, Min, Max y Step . En la tabla siguiente se describen los valores que se pueden agregar a cada clave Ndi\params .

Nombre	Value	Descripción
ParamDesc	String	Nombre que se muestra para el parámetro en la página Avanzadas
Tipo	int, long, Word, dword, edit o enum	Tipo de parámetro: int, long, Word y dword especifican un parámetro numérico; edit y enum especifican un parámetro de texto.
Valor predeterminado	valor predeterminado	Valor predeterminado para el parámetro: para un parámetro numérico, debe ser un valor numérico ( int, long, Word o dword) que coincida con el tipo de parámetro especificado; para un parámetro de texto, debe ser una cadena. Los valores predeterminados deben especificarse para los parámetros necesarios. Los valores predeterminados también se pueden especificar para parámetros opcionales. Cuando un usuario selecciona la opción para escribir un valor para un parámetro opcional, el valor predeterminado, si se especifica, aparece en el cuadro de edición de ese parámetro.
Opcionales	0 o 1	0 requerido. Especifique un valor para el parámetro o use el valor predeterminado. 1 opcional. Se puede marcar como No presente en la página Avanzadas .
Min	valor numérico	Valor mínimo para un parámetro numérico.
Max	valor numérico	Valor máximo para un parámetro numérico.
Paso	valor numérico	Paso (intervalo) entre valores válidos para un parámetro numérico. El valor mínimo es el punto inicial.

El intervalo de valores de un parámetro de enumeración se especifica con una subclave que tiene el formato siguiente:

Ndi\params\SubKeyName\enum

Cada valor enumerado debe tener una subclave. Cada subclave de enumeración especifica un valor numérico (empezando por cero para el primer valor enumerado) y una descripción para ese valor.

A continuación se muestra un ejemplo de una sección add-registry-section que agrega un parámetro de configuración denominado 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)"