Installation du pilote intermédiaire MUX

Cette rubrique fournit une vue d’ensemble des problèmes d’installation du pilote intermédiaire MUX. Pour plus d’informations sur la structure des fichiers INF de pilotes intermédiaires, consultez Configuration requise pour les pilotes intermédiaires MUX réseau.

Un pilote intermédiaire MUX nécessite deux fichiers INF. Le fichier INF de protocole définit les paramètres d’installation pour le bord inférieur du protocole. Le fichier INF miniport définit les paramètres d’installation du bord supérieur du miniport virtuel. Définissez l’entrée INF Class sur Net dans le fichier INF du miniport virtuel et NetTrans dans le fichier INF du protocole. L’exemple de code suivant montre une entrée de classe pour le fichier INF de protocole.

Class = NetTrans

La section DDInstall dans un fichier INF de pilote intermédiaire MUX doit avoir une entrée Caractéristiques . Définissez l’entrée Caractéristiques dans votre fichier INF de protocole, comme illustré dans l’exemple de code suivant.

Characteristics = 0x80

NCF_HAS_UI (0x80) est nécessaire pour activer les pages de propriétés personnalisées, lesquelles, dans ce cas, sont l'objet de notification.

Définissez l’entrée Caractéristiques dans votre fichier INF miniport, comme illustré dans l’exemple de code suivant.

Characteristics = 0x21

La valeur Caractéristiques 0x21 indique que les indicateurs NCF_VIRTUAL (0x1) et NCF_NOT_USER_REMOVABLE (0x20) sont définis. NCF_VIRTUAL spécifie que l’appareil est un adaptateur virtuel. NCF_NOT_USER_REMOVABLE est facultatif et spécifie que l’utilisateur ne peut pas supprimer le pilote intermédiaire. Si vous souhaitez masquer le miniport virtuel de l’utilisateur (vous ne devez pas le faire si votre utilisateur doit installer manuellement des appareils), vous pouvez définir l’indicateur NCF_HIDDEN (0x8). Les indicateurs NCF_Xxx sont définis dans Netcfgx.h. Pour plus d’informations sur l’entrée Caractéristiques et les indicateurs NCF_Xxx , consultez la section DDInstall.

La section DDInstall du fichier INF de protocole pour un pilote intermédiaire MUX doit inclure une directive Addreg pour une clé Ndi . Pour plus d’informations, consultez Ajout de valeurs Service-Related à la section Ndi Key et DDInstall.Services.

En plus des fichiers INF, vous devez également fournir un objet de notification avec un pilote MUX Intermediate. L’objet notify est responsable de l’installation de miniports virtuels. Référencez l’objet notify avec l’entrée ComponentDll dans le protocole INF comme suit :

HKR, Ndi,            ComponentDll,   , mux.dll

L’utilisateur installe le fichier INF de protocole qui définit les paramètres de configuration, copie les fichiers d’installation et installe également la DLL de l’objet notify. L’utilisateur ajoute des miniports virtuels via l’interface utilisateur fournie par l’objet notify. Le fichier INF miniport doit définir l’entrée ExcludeFromSelect pour empêcher l’utilisateur d’installer le fichier INF miniport au lieu du fichier INF de protocole.

Le nom du protocole inscrit par le pilote doit correspondre au nom du service.

HKR, Ndi, Service, 0, MUXP

Les entrées de fichier INF UpperRange et LowerRange déterminent les liaisons d’un pilote intermédiaire MUX. Le fichier INF de protocole doit définir les liaisons de périphérie de protocole, comme l’illustre l’exemple de code suivant.

HKR, Ndi\Interfaces, UpperRange,    0,          "noupper"
HKR, Ndi\Interfaces, LowerRange,    0,          "ndis5"

Le fichier INF miniport doit définir les liaisons de bord supérieur, comme l’illustre l’exemple de code suivant.

HKR, Ndi\Interfaces,    UpperRange, 0,  "ndis5"
HKR, Ndi\Interfaces,    LowerRange, 0,  "nolower"

Vous devez remplacer « ndis5 » dans les exemples de code précédents par les liaisons de protocole requises par votre pilote. Pour plus d’informations sur les liaisons de pilotes intermédiaires et les entrées UpperRange/LowerRange, consultez Entrées de fichier INF UpperRange et LowerRange de pilote intermédiaire.