Spécification des paramètres de configuration pour la page Propriétés avancées

Notes

Avant Windows 10 version 1703, les mises à niveau de pilotes et les mises à jour Windows pouvaient entraîner des modifications des valeurs INF que le pilote avait précédemment définies dans la page Propriétés avancées. À compter de Windows 10, version 1703, les propriétés avancées spécifiées par un pilote dans son fichier INF sont conservées via ces mises à jour.

Un fichier INF qui installe un composant Net (adaptateur) peut spécifier les paramètres de configuration de l’adaptateur à afficher dans la page Propriétés avancées du composant. Les valeurs de configuration spécifiées par l’utilisateur dans la page Propriétés avancées sont écrites dans la clé de instance racine du composant.

Notez que si un adaptateur prend en charge une page de propriétés avancées , l’entrée Caractéristiques dans la section DDInstall de l’adaptateur doit inclure la valeur NCF_HAS_UI.

Un fichier INF réseau spécifie les paramètres de configuration à afficher dans la page Avancé via une section add-registry référencée par la section DDInstall pour le composant. Un tel add-registry-section ajoute une ou plusieurs sous-clés de configuration à la clé Ndi\params . Le format d’une sous-clé de paramètre de configuration est Ndi\params\SubKeyName, où SubKeyName est une valeur REG_SZ qui spécifie un nom de paramètre spécifique au fournisseur. Par exemple, la clé d’un paramètre qui spécifie un type de transceiver peut être nommée Ndi\params\TransceiverType.

Les mots clés suivants sont réservés et ne peuvent pas être utilisés en tant que Ndi\params\SubKeyName : BundleId, BusType, Characteristics, ComponentId, Description, DeviceInstanceId, DriverDate, DriverDesc, DriverVersion, InfPath, InfSection, InfSectionExt,** IfType* InstallTimeStamp, Manufacturer,** MediaType, **NetCfgInstanceId, NetLuidIndex,PhysicalMediaType, **Provideret **ProviderName.

Pour chaque sous-clé de paramètre ajoutée à Ndi\params, la section add-registry doit ajouter des valeurs ParamDesc(description de paramètre) et Type . L’add-registry-section peut également ajouter des valeurs Default et Optional pour le paramètre et, si le paramètre est numérique, les valeurs Min, Max et Step. Le tableau suivant décrit les valeurs qui peuvent être ajoutées à chaque clé Ndi\params .

Nom	Valeur	Description
ParamDesc	Chaîne	Nom affiché pour le paramètre dans la page Avancé
Type	int, long, Word, dword, edit ou enum	Type de paramètre : int, long, Word et dword spécifient un paramètre numérique ; edit et enum spécifient un paramètre de texte.
Default	valeur par défaut	Valeur par défaut du paramètre : pour un paramètre numérique, doit être une valeur numérique ( int, long, Word ou dword) qui correspond au type de paramètre spécifié ; pour un paramètre de texte, doit être une chaîne. Les valeurs par défaut doivent être spécifiées pour les paramètres requis. Les valeurs par défaut peuvent également être spécifiées pour les paramètres facultatifs. Lorsqu’un utilisateur sélectionne l’option permettant d’entrer une valeur pour un paramètre facultatif, la valeur par défaut, si elle est spécifiée, apparaît dans la zone d’édition de ce paramètre.
Facultatif	0 ou 1	0 obligatoire. Spécifiez une valeur pour le paramètre ou utilisez la valeur par défaut. 1 facultatif. Peut être marqué Non présent dans la page Avancé .
Min	valeur numérique	Valeur minimale pour un paramètre numérique.
Max	valeur numérique	Valeur maximale pour un paramètre numérique.
Étape	valeur numérique	Étape (intervalle) entre les valeurs valides pour un paramètre numérique. La valeur minimale est le point de départ.

La plage de valeurs d’un paramètre enum est spécifiée avec une sous-clé au format suivant :

Ndi\params\SubKeyName\enum

Chaque valeur énumérée doit avoir une sous-clé. Chaque sous-clé enum spécifie une valeur numérique (commençant par zéro pour la première valeur énumérée) et une description de cette valeur.

Voici un exemple d’add-registry-section qui ajoute un paramètre de configuration nommé 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)"