Activation et désactivation des fonctionnalités NDK
Pour activer ou désactiver la fonctionnalité NDK, NDIS émet une requête OID OID_NDK_SET_STATE . Un pilote miniport compatible NDK doit inscrire la prise en charge de cet OID dans sa fonction MiniportOidRequest .
Déterminer si la fonctionnalité NDK peut être activée
Le mot clé *NetworkDirect détermine si la fonctionnalité NDK du pilote miniport peut être activée.
Si cette valeur mot clé est définie sur 1 (« Activé »), la fonctionnalité NDK peut être activée.
S’il est défini sur 0 (« Désactivé »), la fonctionnalité NDK ne peut pas être activée.
Lorsque le pilote miniport est installé, son fichier INF définit cette valeur de mot clé sur 1 (« Activé ») par défaut. Pour plus d’informations, consultez Exigences INF pour NDKPI.
Une fois le pilote miniport installé, les administrateurs peuvent mettre à jour la valeur *NetworkDirect mot clé en définissant une nouvelle valeur dans la page de propriétés Avancé de l’adaptateur. Pour plus d’informations sur les propriétés avancées, consultez Spécification des paramètres de configuration pour la page Propriétés avancées.
Note Le pilote miniport est automatiquement redémarré après qu’une modification a été apportée dans la page de propriétés Avancées de l’adaptateur.
Quand activer ou désactiver la fonctionnalité NDK
Ce changement d’état peut être déclenché par une requête OID OID_NDK_SET_STATE , ou par un succès ou un échec dans l’adaptateur lui-même.
Activation ou désactivation de la fonctionnalité NDK
Pour activer ou désactiver sa fonctionnalité NDK, le pilote miniport doit envoyer un événement NetEventNDKEnable ou NetEventNDKDisable Plug-and-Play (PnP) à NDIS.
Pour envoyer l’événement PnP, le pilote miniport appelle la fonction NdisMNetPnPEvent , en définissant le membre NetPnPEvent de la structure NET_PNP_EVENT_NOTIFICATION vers laquelle le paramètre NetPnPEvent pointe comme suit :
NetEventNDKEnable si la fonctionnalité NDK doit être activée.
NetEventNDKDisable si la fonctionnalité NDK doit être désactivée.
L’événement NetEventNDKDisable PnP déclenche les pilotes NDIS et de couche supérieure pour commencer à fermer leurs instances NDK_ADAPTER ouvertes sur l’adaptateur où la fonctionnalité NDK est désactivée. L’événement PnP reste en attente jusqu’à ce que toutes les instances NDK_ADAPTER ouvertes sur l’adaptateur soient fermées.