NdisOpenConfigurationEx, fonction (ndis.h)

Article
02/07/2025

Les pilotes NDIS appellent la fonction NdisOpenConfigurationEx pour obtenir un handle de configuration qui permet d’accéder aux paramètres de configuration dans le Registre.

Syntaxe

NDIS_STATUS NdisOpenConfigurationEx(
  [in]  PNDIS_CONFIGURATION_OBJECT ConfigObject,
  [out] PNDIS_HANDLE               ConfigurationHandle
);

Paramètres

[in] ConfigObject

Pointeur vers un appelant fourni et initialisé structure NDIS_CONFIGURATION_OBJECT.

[out] ConfigurationHandle

Pointeur vers une variable fournie par l’appelant dans laquelle NdisOpenConfigurationEx retourne un handle à une clé de Registre. La clé de Registre identifie les paramètres de configuration.

Valeur de retour

NdisOpenConfigurationEx retourne l’une des valeurs d’état suivantes :

Retourner le code	Description
NDIS_STATUS_SUCCESS	NdisOpenConfigurationEx correctement ouvert la clé de Registre où les paramètres de configuration du pilote sont stockés.
NDIS_STATUS_RESOURCES	NdisOpenConfigurationEx a échoué en raison de ressources insuffisantes.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx retourne NDIS_STATUS_FAILURE si aucune des valeurs précédentes ne s’applique.

Remarques

NdisOpenConfigurationEx retourne un handle de configuration au paramètre ConfigurationHandle. Le handle de configuration est associé à une clé de Registre qui identifie l’emplacement des paramètres de configuration. L’appelant peut transmettre le handle de configuration à d’autres fonctions de configuration NDIS pour lire ou écrire des informations dans le Registre.

Pour accéder aux informations de configuration, utilisez le handle de configuration avec les fonctions suivantes :

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

Le type de données de Registre associées au handle de configuration dépend du type de handle que l’appelant passe à NdisOpenConfigurationEx dans le membre NdisHandle du membre NDIS_CONFIGURATION_OBJECT structure référencée par le paramètre ConfigObject. Le handle peut identifier les paramètres associés au pilote ou à une instance du pilote.

Si le pilote a obtenu le handle dans NdisHandle en appelant le fonction NdisMRegisterMiniportDriver, NdisOpenConfigurationEx fournit un handle à l’emplacement du Registre où les paramètres de configuration du pilote miniport sont stockés. Le pilote miniport peut utiliser le handle de configuration jusqu’à ce qu’il appelle le fonction NdisMDeregisterMiniportDriver.

Si le pilote a obtenu le handle dans NdisHandle à partir du paramètre MiniportAdapterHandle de la fonction MiniportInitializeEx, NdisOpenConfigurationEx fournit un handle à l’emplacement du Registre où les paramètres de configuration d’un adaptateur miniport sont stockés. Un pilote miniport peut transmettre le handle de configuration à la fonction NdisReadNetworkAddress pour récupérer les informations d’adresse réseau qui peuvent être configurées par logiciel et administrées localement. Les pilotes Miniport peuvent utiliser le handle de configuration jusqu’à ce que NDIS arrête l’adaptateur miniport et que la fonction MiniportHaltEx retourne.

Si le pilote a obtenu le handle dans NdisHandle en appelant le fonction NdisRegisterProtocolDriver, NdisOpenConfigurationEx fournit un handle à l’emplacement de Registre où les paramètres de configuration du pilote de protocole sont stockés. Le pilote de protocole peut utiliser le handle de configuration jusqu’à ce qu’il appelle le fonction NdisDeregisterProtocolDriver.

Si le handle dans NdisHandle est un pointeur vers une structure NDIS_BIND_PARAMETERS que NDIS a passée au paramètre BindParameters de la fonction ProtocolBindAdapterEx, NdisOpenConfigurationEx fournit un handle à l’emplacement du Registre où les paramètres de configuration d’une liaison de protocole sont stockés. Les pilotes de protocole peuvent utiliser le handle de configuration jusqu’à ce que l’opération de liaison soit terminée.

Si le pilote a obtenu le handle dans NdisHandle en appelant la fonction NdisOpenAdapterEx, NdisOpenConfigurationEx fournit un handle à l’emplacement de Registre où les paramètres de configuration d’une liaison de protocole sont stockés. Le pilote de protocole peut utiliser le handle de configuration jusqu’à ce qu’il appelle la fonction NdisCloseAdapterEx.

Si un pilote de filtre a obtenu le handle dans NdisHandle en appelant le fonction NdisFRegisterFilterDriver, NdisOpenConfigurationEx fournit un handle à l’emplacement du Registre où les paramètres de configuration du pilote de filtre sont stockés. Les pilotes de filtre peuvent utiliser le handle de configuration jusqu’à ce qu’ils appellent le fonction NdisFDeregisterFilterDriver.

Si un pilote de filtre a obtenu le handle dans NdisHandle à partir du paramètre NdisFilterHandle de la fonction FilterAttach, NdisOpenConfigurationEx fournit un handle à l’emplacement du Registre où sont stockés les paramètres de configuration des modules de filtre. Le pilote de filtre peut utiliser le handle de configuration jusqu’à ce que NDIS détache le module de filtre et que la fonction FilterDetach retourne. Si un pilote de filtre de surveillance spécifie l’indicateur de NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION dans les indicateurs de membre du NDIS_CONFIGURATION_OBJECT structure, le pilote peut accéder à la configuration du module de filtre pour un module de filtre spécifique lorsqu’il existe plusieurs modules de filtre configurés sur le même adaptateur miniport. La modification des pilotes de filtre ne doit pas utiliser cet indicateur.

Une fois qu’un pilote a terminé d’accéder aux informations de configuration, le pilote doit appeler la fonction NdisCloseConfiguration pour libérer le handle de configuration et les ressources associées.

Remarque Pour être sûr que cette fonction s’exécute à IRQL = PASSIVE_LEVEL, un pilote peut planifier un élément de travail NDIS et appeler cette fonction et d’autres fonctions de configuration dans le contexte du rappel d’élément de travail.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Universel
d’en-tête	ndis.h (include Ndis.h)
bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
règles de conformité DDI	Irql_Miscellaneous_Function(ndis), NdisOpenConfigurationEx(ndis)