Lire en anglais

Partager via

NdisOpenProtocolConfiguration, fonction (ndis.h)

  • Article

Remarque 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. pilotes x vers 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 état d’échec lors du 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 lie ultérieurement. Les entrées de valeur sous cette clé contiennent des informations spécifiques au protocole installées sur l’adaptateur.

[in] ProtocolSection

Pointeur vers un type NDIS_STRING fourni par l’appelant contenant une chaîne comptée, spécifié dans le jeu de caractères par défaut système. Cette chaîne comptée nomme le pilote de carte réseau NDIS, en fait l’adaptateur, pour lequel la clé de paramètres par adaptateur dans la section du protocole de 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 en tant que type UNICODE_STRING.

Ce pointeur est le paramètre d’entrée SystemSpecific1 de l’appelant vers la fonction ProtocolBindAdapter de l’appelant.

Valeur de retour

Aucun

Remarques

NdisOpenProtocolConfiguration retourne un handle que l’appelant peut passer par la suite au Ndis.. Configuration fonctions 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.. Configuration fonctions, telles que NdisRead/WriteConfiguration ou NdisOpenConfigurationKeyByName/Index, si ses informations de configuration spécifiques à l’adaptateur d’installation dans la section 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érieurs appellent les routines de prise en charge du mode noyau pour ouvrir leurs propres clés de Registre spécifiques au protocole. Pour plus d’informations sur ces routines de support, consultez le Résumé des routines de support Kernel-Mode et routines de support Power Management.

  • 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.

Exigences

Exigence Valeur
d’en-tête ndis.h (include Ndis.h)
bibliothèque Ndis.lib
IRQL PASSIVE_LEVEL

Voir aussi