NdisOpenProtocolConfiguration, fonction (ndis.h)
Note NDIS 5. x a été déconseillé et est remplacé par NDIS 6. x. Pour le développement de nouveaux pilotes NDIS, consultez Pilotes réseau à partir de Windows Vista. Pour plus d’informations sur le portage de NDIS 5. x pilotes dans NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.
NdisOpenProtocolConfiguration retourne un handle pour la clé de Registre dans laquelle les informations par adaptateur d’un pilote de protocole sont stockées.
Syntaxe
void NdisOpenProtocolConfiguration(
[out] PNDIS_STATUS Status,
[out] PNDIS_HANDLE ConfigurationHandle,
[in] PCNDIS_STRING ProtocolSection
);
Paramètres
[out] Status
Pointeur vers une variable fournie par l’appelant qui est définie sur NDIS_STATUS_SUCCESS ou un échec status en retour de cette fonction.
[out] ConfigurationHandle
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne le handle à la clé de Registre pour le pilote miniport nommé auquel l’appelant se liera ultérieurement. Les entrées de valeur sous cette clé contiennent des informations spécifiques à l’adaptateur installées par le protocole.
[in] ProtocolSection
Pointeur vers un type de NDIS_STRING fourni par l’appelant contenant une chaîne comptée, spécifiée dans le jeu de caractères par défaut du système. Cette chaîne comptée nomme le pilote de carte réseau NDIS, en fait l’adaptateur, pour lequel la clé des paramètres par adaptateur dans la section protocole du Registre doit être ouverte. Pour les protocoles Windows 2000 et ultérieurs, cette chaîne comptée contient des caractères Unicode. Autrement dit, pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .
Ce pointeur est le paramètre d’entrée SystemSpecific1 vers la fonction ProtocolBindAdapter de l’appelant.
Valeur de retour
None
Remarques
NdisOpenProtocolConfiguration retourne un handle que l’appelant peut passer par la suite au Ndis.. Fonctions de configuration pour récupérer ou stocker des informations dans le Registre.
Un pilote de protocole appelle NdisOpenProtocolConfiguration pour obtenir un handle de clé de Registre à passer ultérieurement à d’autres Ndis.. Les fonctions de configuration , telles que NdisRead/WriteConfiguration ou NdisOpenConfigurationKeyByName/Index, si son fichier d’installation stockait des informations de configuration spécifiques à l’adaptateur dans la section de protocole du Registre à partir de laquelle le protocole configure ses liaisons.
Un protocole peut appeler NdisOpenConfigurationKeyByName ou NdisOpenConfigurationKeyByIndex pour ouvrir n’importe quelle sous-clé de la clé de Registre pour laquelle NdisOpenProtocolConfiguration retourne le handle.
Les protocoles Windows 2000 et ultérieur appellent des routines en mode noyau pour ouvrir leurs propres clés de Registre spécifiques au protocole. Pour plus d’informations sur ces routines de support, consultez Résumé des routines de support Kernel-Mode et routines de support de gestion de l’alimentation.
- Plateforme cible : universelle
- Version : non pris en charge pour les pilotes NDIS 6.0 dans Windows Vista. Utilisez NdisOpenConfigurationExà la place. Pris en charge pour les pilotes NDIS 5.1 dans Windows Vista et Windows XP.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | PASSIVE_LEVEL |