Especificando parâmetros de configuração para a página Propriedades Avançadas

Observação

Antes de Windows 10, versão 1703, atualizações de driver e atualizações do Windows poderiam resultar em alterações nos valores INF que o driver havia definido anteriormente na página Propriedades avançadas. A partir do Windows 10, versão 1703, as propriedades avançadas especificadas por um driver em seu arquivo INF persistem por meio dessas atualizações.

Um arquivo INF que instala um componente Net (adaptador) pode especificar parâmetros de configuração do adaptador para exibição na página Propriedades avançadas do componente. Os valores de configuração especificados pelo usuário na página Propriedades avançadas são gravados na chave de instância raiz do componente.

Observe que, se um adaptador der suporte a uma página Propriedades avançadas , a entrada Características na seção DDInstall para o adaptador deverá incluir o valor NCF_HAS_UI.

Um arquivo INF de rede especifica parâmetros de configuração para exibição na página Avançado por meio de uma seção add-registry que é referenciada pela seção DDInstall para o componente. Essa seção add-registry adiciona uma ou mais subchaves de configuração à chave Ndi\params . O formato de uma subchave de parâmetro de configuração é Ndi\params\SubKeyName, em que SubKeyName é um valor REG_SZ que especifica um nome de parâmetro específico do fornecedor. Por exemplo, a chave de um parâmetro que especifica um tipo de transceptor pode ser chamada de Ndi\params\TransceiverType.

As seguintes palavras-chave são reservadas e não podem ser usadas como um Ndi\params\SubKeyName: BundleId, BusType, Characteristics, ComponentId, Description, DeviceInstanceId, DriverDate, DriverDesc, DriverVersion, InfPath, InfSection, InfSectionExt,** IfType* InstallTimeStamp, Manufacturer,** MediaType, **NetCfgInstanceId, NetLuidIndex,PhysicalMediaType, **Providere **ProviderName.

Para cada subchave de parâmetro adicionada a Ndi\params, a seção add-registry deve adicionar valores ParamDesc(parameter description) e Type . A seção add-registry também pode adicionar valores Padrão e Opcional para o parâmetro e, se o parâmetro for numérico, Min, Max e Step valores. A tabela a seguir descreve os valores que podem ser adicionados a cada chave Ndi\params .

Nome	Valor	Descrição
Paramdesc	Cadeia de caracteres	Nome exibido para o parâmetro na página Avançado
Digite	int, long, Word, dword, editar ou enumerar	Tipo de parâmetro: int, long, Word e dword especificam um parâmetro numérico; editar e enumerar especificar um parâmetro de texto.
Padrão	valor padrão	Valor padrão para o parâmetro: para um parâmetro numérico, deve ser um valor numérico (int, long, Word ou dword) que corresponda ao tipo de parâmetro especificado; para um parâmetro de texto, deve ser uma cadeia de caracteres. Os valores padrão devem ser especificados para os parâmetros necessários. Os valores padrão também podem ser especificados para parâmetros opcionais. Quando um usuário seleciona a opção para inserir um valor para um parâmetro opcional, o valor padrão, se especificado, aparece na caixa de edição desse parâmetro.
Opcional	0 ou 1	0 necessário. Especifique um valor para o parâmetro ou use o valor padrão. 1 opcional. Pode ser marcado como Não Presente na página Avançado .
Min	valor numérico	Valor mínimo para um parâmetro numérico.
Max	valor numérico	Valor máximo para um parâmetro numérico.
Etapa	valor numérico	Etapa (intervalo) entre valores válidos para um parâmetro numérico. O valor mínimo é o ponto de partida.

O intervalo de valores para um parâmetro de enumeração é especificado com uma subchave que tem o seguinte formato:

Ndi\params\SubKeyName\enum

Cada valor enumerado deve ter uma subchave. Cada subchave de enumeração especifica um valor numérico (começando com zero para o primeiro valor enumerado) e uma descrição para esse valor.

Veja a seguir um exemplo de uma seção add-registry que adiciona um parâmetro de configuração chamado 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)"